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A SYSTEM, METHOD AND ARTICLE OF MANUFACTURE FOR 
SECURE, STORED VALUE TRANSACTIONS OVER AN OPEN COMMUNICATION 
NETWORK UTILIZING AN EXTENSIBLE, FLEXIBLE ARCHITECTURE 

5 Field Of The Invention 

The present invention relates to the secure, electronic payment in exchange for goods and 
services purchased over a communication network, and more specifically, to a system, method 
and article of manufacture for securely transmitting value transfers from one smart card to 
another smart card over an open, communication network utilizing a flexible, extensible 
10 architecture. 



The present invention relates to an electronic representation of a monetary system for 
implementing electronic money payments as an alternative medium of economic exchange to 
cash, checks, credit and debit cards, and electronic funds transfer. The Electronic- Monetary 
15 System is a hybrid of currency, check, card payment systems, and electronic funds transfer 
systems, possessing many of the benefits of these systems with few of their limitations. The 
system utilizes electronic representations of money which are designed to be universally 
accepted and exchanged as economic value by subscribers of the monetary system. 



Today, approximately 350 billion coin and currency transactions occur between individuals and 
institutions every year. The extensive use of coin and currency transactions has limited the 
automation of individual transactions such as purchases, fares, and bank account deposits 
and withdrawals. Individual cash transactions are burdened by the need to have the correct 
amount of cash or providing change therefor. Furthermore, the handling and managing of 
paper cash and coins is inconvenient, costly and time consuming for both individuals and 
financial institutions. 

Although checks may be written for any specific amount up to the amount available in the 
account, checks have very limited transferability and must be supplied from a physical 
inventory. Paper-based checking systems do not offer sufficient relief from the limitations of 
cash transactions, sharing many of the inconveniences of handling currency while adding the 
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inherent delays associated with processing checks. To this end, economic exchange has striven 
for greater convenience at a lower cost, while also seeking improved security. 

Automation has achieved some of these qualities for large transactions through computerized 
5 electronic funds transfer ("EFT") systems. Electronic funds transfer is essentially a process of 
value exchange achieved through the banking system's centralized computer transactions. EFT 
services are a transfer of payments utilizing electronic "checks," which are used primarily by 
large commercial organizations. 

10 The Clearing House (ACH) where a user can enter a pre-authorized code and download 

information with billing occurring later, and a Point Of Sale (POS) system where a transaction 
is processed by connecting with a central computer for authorization for the transaction 
granted or denied immediately are examples of EFT systems that are utilized by retail and 
commercial organizations. However, the payments made through these types of EFT systems 

1 5 are limited in that they cannot be performed without the banking system. Moreover, ACH 
transactions usually cannot be performed during off business hours. 

Home Banking bill payment services are examples of an EFT system used by individuals to 
make payments from a home computer. Currently, home banking initiatives have found few 
20 customers. Of the banks that have offered services for payments, account transfers and 

information over the telephone lines using personal computers, less than one percent of the 
bank's customers are using the service. One reason that Home Banking has not been a 
successful product is because the customer cannot deposit and withdraw money as needed in 
this type of system. 

25 

Current EFT systems, credit cards, or debit cards, which are used in conjunction with an on- 
line system to transfer money between accounts, such as between the account of a merchant 
and that of a customer, cannot satisfy the need for an automated transaction system providing 
an ergonomic interface. Examples of EFT systems which provide non-ergonomic interfaces are 
30 disclosed in US Patents Numbers 5,476,259; 5,459,304; 5,452,352; 5,448,045; 5,478,993; 
5,455,407; 5,453,601; 5,465,291; and 5,485,510. 



WO 98/05011 



- 3 - 



PCT/US97/13673 



To implement an automated, convenient transaction that can dispense some form of economic 
value, there has been a trend towards off-line payments. For example, numerous ideas have 
been proposed for some form of "electronic money" that can be used in cashless payment 
transactions as alternatives to the traditional currency and check types of payment systems. 
See U.S. Pat. No. 4,977,595, entitled "METHOD AND APPARATUS FOR IMPLEMENTING 
ELECTRONIC CASH," and U.S. Pat. No. 4,305,059, entitled "MODULAR FUNDS TRANSFER 
SYSTEM/ 

The more well known techniques include magnetic stripe cards purchased for a given amount 
and from which a prepaid value can be deducted for specific purposes. Upon exhaustion of the 
economic value, the cards are thrown away. Other examples include memory cards or so called 
smart cards which are capable of repetitively storing information representing value that is 
likewise deducted for specific purposes. 

It is desirable for a computer operated under the control of a merchant to obtain information 
offered by a customer and transmitted by a computer operating under the control of the 
customer over a publicly accessible packet- switched network (e.g., the Internet) to the 
computer operating under the control of the merchant, without risking the exposure of the 
information to interception by third parties that have access to the network, and to assure that 
the information is from an authentic source. It is further desirable for the merchant to 
transmit information, including a subset of the information provided by the customer, over 
such a network to a payment gateway computer system that is designated, by a bank or other 
financial institution that has the responsibility of providing payment on behalf of the customer, 
to authorize a commercial transaction on behalf of such a financial institution, without the risk 
of exposing that information to interception by third parties. Such institutions include, for 
example, financial institutions offering credit or debit card services. 

One such attempt to provide such a secure transmission channel is a secure payment 
technology such as Secure Electronic Transaction (hereinafter "SET), jointly developed by the 
Visa and MasterCard card associations, and described in Visa and MasterCard s Secure 
Electronic Transaction (SET) Specification, February 23, 1996, hereby incorporated by reference. 
Other such secure payment technologies include Secure Transaction Technology ("STT), 
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Secure Electronic Payments Protocol ("SEPP"), Internet Keyed Payments ("iKP"), Net Trust, and 
Cybercash Credit Payment Protocol. One of ordinary skill in the art readily comprehends that 
any of the secure payment technologies can be substituted for the SET protocol without undue 
experimentation. Such secure payment technologies require the customer to operate software 
that is compliant with the secure payment technology, interacting with third-party certification 
authorities, thereby allowing the customer to transmit encoded information to a merchant, 
some of which may be decoded by the merchant, and some which can be decoded only by a 
payment gateway specified by the customer. 

Another such attempt to provide such a secure transmission channel is a general-purpose 
secure communication protocol such as Netscape, Inc.'s Secure Sockets Layer (hereinafter 
"SSL") , as described in Freier, Karlton & Kocher (hereinafter "Freier"), The SSL Protocol Version 
3 A March 1996, and hereby incorporated by reference. SSL provides a means for secure 
transmission between two computers. SSL has the advantage that it does not require special- 
purpose software to be installed on the customer s computer because it is already incorporated 
into widely available software that many people utilize as their standard Internet access 
medium, and does not require that the customer interact with any third-party certification 
authority. Instead, the support for SSL may be incorporated into software already in use by 
the customer, e.g., the Netscape Navigator World Wide Web browsing tool. However, although a 
computer on an SSL connection may initiate a second SSL connection to another computer, a 
drawback to the SSL approach is each SSL connection supports only a two-computer 
connection. Therefore, SSL does not provide a mechanism for transmitting encoded 
information to a merchant for retransmission to a payment gateway such that a subset of the 
information is readable to the payment gateway but not to the merchant. Although SSL allows 
for robustly secure two-party data transmission, it does not meet the ultimate need of the 
electronic commerce market for robustly secure three-party data transmission. Other 
examples of general-purpose secure communication protocols in dude Private Communications 
Technology ("PCT) from Microsoft, Inc., Secure Hyper-Text Transport Protocol ("SHTTF) from 
Terisa Systems, Shen, Kerberos, Photuris, Pretty Good Privacy f'PGF ) which meets the IPSEC 
criteria. One of ordinary skill in the art readily comprehends that any of the general-purpose 
secure communication protocols can be substituted for the SSL transmission protocol without 
undue experimentation. 
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Banks desire an Internet payment solution that emulates existing Point of Sale (POS) 
applications that are currently installed on their host computers, and require minimal changes 
to their host systems. This is a critical requirement since any downtime for a banks host 
5 computer system represents an enormous expense. Currently, VeriFone supports over fourteen 
hundred different payment-related applications. The large number of applications is necessary 
to accommodate a wide variety of host message formats, diverse methods for communicating to 
a variety of hosts with different dial-up and direct-connect schemes, and different certification 
around the world. In addition, there are a wide variety of business processes that dictate how a 

10 Point of Sale (POS) terminal queries a user for data and subsequently displays the data. Also, 
various vertical market segments, such as hotels, car rental agencies, restaurants, retail sales, 
mail sales / telephone sales require interfaces for different types of data to be entered, and 
provide different discount rates to merchants for complying with various data types. Moreover, 
a plethora of report generation mechanisms and formats are utilized by merchants that 

1 5 banking organizations work with. 

Banks are unwilling to converge on "standards" since convergence would facilitate switching 
from one acquiring bank to another by merchants. In general, banks desire to increase the 
cost that a merchant incurs in switching from one acquiring bank to another acquiring bank. 
20 This is accomplished by supplying a merchant with a terminal that only communicates utilizing 
the bank's proprietary protocol, and by providing other value-added services that a merchant 
may not be able to obtain at another bank. 

Intemet-based payment solutions require additional security measures that are not found in 
25 conventional POS terminals. This additional requirement is necessitated because Internet 
communication is done over publicly-accessible, unsecured communication line in stark 
contrast to the private, secure, dedicated phone or leased line service utilized between a 
traditional merchant and an acquiring bank. Thus, it is critical thai any solution utilizing the 
Internet for a communication backbone, employ some form of cryptography. 

30 

As discussed above, the current state-of-the-art in Internet based payment processing is a 
protocol referred to as SET. Since the SET messages are uniform across all implementations, 
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banks cannot differentiate themselves in any reasonable way. Also, since SET is not a proper 
superset of all protocols utilized today, there are bank protocols which cannot be mapped or 
translated into SET because they require data elements for which SET has no placeholder. 
Further, SET only handles the message types directly related to authorizing and capturing 
5 credit card transactions and adjustments to these authorizations or captures. In a typical POS 
terminal in the physical world, these messages comprise almost the entire volume of the total 
number of messages between the merchant and the authorizing bank, but only half of the total 
number of different message types. These message types, which are used infrequently, but 
which are critical to the operation of the POS terminal must be supported for proper 
1 0 transaction processing. 

Recently, the Internet was proposed as a communication medium connecting personal 
computers with specialized reader hardware for facilitating reading and writing to smart cards. 
However, the Internet is not a secure communication medium and value transfer was not 

15 secured. Thus, a solution was necessary to shore up the Internet with secure value transfer 
processing to facilitate smart card processing over the Internet. In addition, support was 
required to ensure that no third party could hijack a value transfer transaction. This would 
occur if someone diverted the transaction before it even started. In the prior art face-to-face 
solution, both parties can confirm the other party's identity. However, the Internet separates 

20 the parties with miles of wire. 

SUMMARY OF THE INVENTION 

According to a broad aspect of a preferred embodiment of the invention, secure transmission of 
a value transfer protocol transaction is provided between a plurality of computer systems over a 

25 public communication system, such as the Internet. A connection is created between two 
computer systems using a public network, such as the Internet, to connect the computers. 
Then, digital certificates and a digital signature are exchanged to ensure that both parties are 
who they say they are. Finally, the two smart cards involved in a transaction are read by 
individual computers connected utilizing the network, and the value transfer protocol is 

30 executed over the secured network. The value transfer protocoi facilitates the exchange of 
money between the two smart cards. 
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DESCRIPTION OF THE DRAWINGS 

The foregoing and other objects, aspects and advantages are better understood from the 
following detailed description of a preferred embodiment of the invention with reference to the 
5 drawings, in which: 

Figure 1A is a block diagram of a representative hardware environment in accordance with a 
preferred embodiment; 

10 Figure IB depicts an overview in accordance with a preferred embodiment; 

Figure 1C is a block diagram of the system in accordance with a preferred embodiment; 

Figure 2 depicts a more detailed view of a customer computer system in communication with 
15 merchant system under the Secure Sockets Layer protocol in accordance with a preferred 
embodiment; 

Figure 3 depicts an overview of the method of securely supplying payment information to a 
payment gateway in order to obtain payment authorization in accordance with a preferred 
20 embodiment; 

Figure 4 depicts the detailed steps of generating and transmitting a payment authorization 
request in accordance with a preferred embodiment; 

25 Figures 5A through 5F depict views of the payment authorization request and its component 
parts in accordance with a preferred embodiment; 

Figures 6A and 6B depict the detailed steps of processing a payment authorization request and 
generating and transmitting a payment authorization request response in accordance with a 
30 preferred embodiment; 
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Figures 7A through 7J depict views of the payment authorization response and its component 
parts in accordance with a preferred embodiment; 

Figure 8 depicts the detailed steps of processing a payment authorization response in 
5 accordance with a preferred embodiment; 

Figure 9 depicts an overview of the method of securely supplying payment capture information 
to a payment gateway in accordance with a preferred embodiment; 

10 Figure 10 depicts the detailed steps of generating and transmitting a payment capture request 
in accordance with a preferred embodiment; 

Figures 11A through 11F depict views of the payment capture request and its component parts 
in accordance with a preferred embodiment; 

15 

Figures 12A and 12B depict the detailed steps of processing a payment capture request and 
generating and transmitting a payment capture request response in accordance with a 
preferred embodiment; 

20 Figures 13A through 13F depict views of the payment capture response and its component 
parts in accordance with a preferred embodiment; 

Figure 14 depicts the detailed steps of processing a payment capture response in accordance 
with a preferred embodiment; 

Figure 15A & 15B depicts transaction processing of merchant and consumer transactions in 
accordance with a preferred embodiment; 

Figure 16 illustrates a transaction class hierarchy block diagram in accordance with a 
30 preferred embodiment; 



Figure 17 shows a typical message flow between the merchant, vPOS terminal and the Gateway 
in accordance with a preferred embodiment; 
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Figures 18A-E are block diagrams of the extended SET architecture in accordance with a 
preferred embodiment; 

5 Figure 19 is a flowchart of vPOS merchant pay customization in accordance with a preferred 
embodiment; 

Figures 20A-20H are block diagrams and flowcharts setting forth the detailed logic of thread 
processing in accordance with a preferred embodiment; 



10 



20 



Figure 21 is a detailed diagram of a multithreaded gateway engine in accordance with a 
preferred embodiment; 



Figure 22 is a flow diagram in accordance with a preferred embodiment; 
15 Figure 23 illustrates a Gateway's role in a network in accordance with a preferred embodiment; 

Figure 24 is a block diagram of the Gateway in accordance with a preferred embodiment; 

Figure 25 is a block diagram of the vPOS Terminal Architecture in accordance with a preferred 
embodiment; 

Figure 26 is an architecture block diagram in accordance with a preferred embodiment; 



Figure 27 is a block diagram of the payment manager architecture in accordance with a 
preferred embodiment; 



Figure 28 is a Consumer Payment Message Sequence Diagram in accordance with a preferred 
25 embodiment of the invention; 



Figure 29 is an illustration of a certificate issuance form in accordance with a preferred 
embodiment; 
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Figure 30 illustrates a certificate issuance response in accordance with a preferred 
embodiment; 

Figure 31 illustrates a collection of payment instrument holders in accordance with a preferred 
5 embodiment; 

Figure 32 illustrates the default payment instrument bitmap in accordance with a preferred 
embodiment; 

10 Figure 33 illustrates a selected payment instrument with a fill in the blanks for the cardholder 
in accordance with a preferred embodiment; 

Figure 34 illustrates a coffee purchase utilizing the newly defined VISA card in accordance with 
a preferred embodiment of the invention; 

15 

Figure 35 is a flowchart of conditional authorization of payment in accordance with a preferred 
embodiment; 

Figures 36-48 are screen displays in accordance with a preferred embodiment; 

20 

Figure 49 shows how the vPOS authenticates an incoming response to a request in accordance 
with a preferred embodiment; 

Figure 50 is a flowchart for the merchant interaction with the Test Gateway in accordance with 
25 a preferred embodiment; 

Figures 51-6X are flowcharts depicting the detailed logic of the gateway in accordance with a 
preferred embodiment; 

30 Figure 62 is the main administration display for the Gateway in accordance with a preferred 
embodiment; 
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Figure 63 is a configuration panel in accordance with a preferred embodiment. 

Figure 64 is a host communication display for facilitating communication between the gateway 
and the acquirer payment host in accordance with a preferred embodiment; 

5 

Figure 65 is a Services display in accordance with a preferred embodiment; 

Figure 66 is a graphical representation of the gateway transaction database in accordance with 
a preferred embodiment; and 

10 

Figure 67 illustrates a payment architecture in accordance with a preferred embodiment. 

DETAILED DESCRIPTION 

15 A preferred embodiment of a system in accordance with the present invention is preferably 
practiced in the context of a personal computer such as the IBM PS/2, Apple Macintosh 
computer or UNIX based workstation. A representative hardware environment is depicted in 
Figure 1 A, which illustrates a typical hardware configuration of a workstation in accordance 
with a preferred embodiment having a central processing unit 10, such as a microprocessor, 

20 and a number of other units interconnected via a system bus 12. The workstation shown in 
Figure 1A includes a Random Access Memory (RAM) 14, Read Only Memory (ROM) 16, an I/O 
adapter 18 for connecting peripheral devices such as disk storage units 20 to the bus 12, a 
user interface adapter 22 for connecting a keyboard 24, a mouse 26. a speaker 28, a 
microphone 32, and/or other user interface devices such as a touch screen (not shown) to the 

25 bus 12, communication adapter 34 for connecting the workstation to a communication 

network (e.g., a data processing network) and a display adapter 36 for connecting the bus 12 to 
a display device 38. The workstation typically has resident thereon an operating system such 
as the Microsoft Windows NT or Windows/95 Operating System (OS), the IBM OS/2 operating 
system, the MAC OS, or UNIX operating system. Those skilled in the art will appreciate that 

30 the present invention may also be implemented on platforms and operating systems other than 
those mentioned. 
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A preferred embodiment is written using JAVA, C, and the C++ language and utilizes object 
oriented programming methodology. Object oriented programming (OOP) has become 
increasingly used to develop complex applications. As OOP moves toward the mainstream of 
software design and development, various software solutions require adaptation to make use of 
5 the benefits of OOP. A need exists for these principles of OOP to be applied to a messaging 
interface of an electronic messaging system such that a set of OOP classes and objects for the 
messaging interface can be provided. 

OOP is a process of developing computer software using objects, including the steps of 
10 analyzing the problem, designing the system, and constructing the program. An object is a 

software package that contains both data and a collection of related structures and procedures. 

Since it contains both data and a collection of structures and procedures, it can be visualized 

as a self-sufficient component that does not require other additional structures, procedures or 

data to perform its specific task. OOP, therefore, views a computer program as a collection of 
1 5 largely autonomous components, called objects, each of which is responsible for a specific task. 

This concept of packaging data, structures, and procedures together in one component or 

module is called encapsulation. 

In general, OOP components are reusable software modules which present an interface that 
20 conforms to an object model and which are accessed at run-time through a component 
integration architecture. A component integration architecture is a set of architecture 
mechanisms which allow software modules in different process spaces to utilize each others 
capabilities or functions. This is generally done by assuming a common 
component object model on which to build the architecture. 

25 

It is worthwhile to differentiate between an object and a class of objects at this point. An object 
is a single instance of the class of objects, which is often just called a class. A class of objects 
can be viewed as a blueprint, from which many objects can be formed. 

30 OOP allows the programmer to create an object that is a part of another object. For example, 
the object representing a piston engine is said to have a composition- relationship with the 
object representing a piston. In reality, a piston engine comprises a piston, valves and many 
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other components; the fact that a piston is an element of a piston engine can be logically and 
semanticaily represented in OOP by two objects. 

OOP also allows creation of an object that "depends from* another object. If there are two 
5 objects, one representing a piston engine and the other representing a piston engine wherein 
the piston is made of ceramic, then the relationship between the two objects is not that of 
composition. A ceramic piston engine does not make up a piston engine. Rather it is merely 
one kind of piston engine that has one more limitation than the piston engine; its piston is 
made of ceramic. In this case, the object representing the ceramic piston engine is called a 
10 derived object, and it inherits all of the aspects of the object representing the piston engine and 
adds further limitation or detail to it. The object representing the ceramic piston engine 
"depends from" the object representing the piston engine. The relationship between these 
objects is called inheritance. 

15 When the object or class representing the ceramic piston engine inherits all of the aspects of 
the objects representing the piston engine, it inherits the thermal characteristics of a standard 
piston defined in the piston engine class. However, the ceramic piston engine object overrides 
these ceramic specific thermal characteristics, which are typically different from those 
associated with a metal piston. It skips over the original and uses new functions related to 

20 ceramic pistons. Different kinds of piston engines have different characteristics, but may have 
the same underlying functions associated with it (e.g., how many pistons in the engine, ignition 
sequences, lubrication, etc.). To access each of these functions in any piston engine object, a 
programmer would call the same functions with the same names, but each type of piston 
engine may have different /overriding implementations of functions behind the same name. 

25 This ability to hide different implementations of a function behind the same name is called 
polymorphism and it greatly simplifies communication among objects. 

With the concepts of composition -relation ship, encapsulation, inheritance and polymorphism, 
an object can represent just about anything in the real world. In fact, our logical perception of 
30 the reality is the only limit on determining the kinds of things that can become objects in 
object-oriented software. Some typical categories are as follows: 
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Objects can represent physical objects, such as automobiles in a traffic-flow simulation, 
electrical components in a circuit-design program, countries in an economics model, or 
aircraft in an air- traffic-control system. 

Objects can represent elements of the computer-user environment such as windows, 
menus or graphics objects. 

An object can represent an inventory, such as a personnel file or a table of the latitudes 
and longitudes of cities. 

An object can represent user-defined data types such as time, angles, and complex 
numbers, or points on the plane. 

With this enormous capability of an object to represent just about any logically separable 
matters, OOP allows the software developer to design and implement a computer program that 
is a model of some aspects of reality, whether that reality is a physical entity, a process, a 
system, or a composition of matter. Since the object can represent anything, the software 
developer can create an object which can be used as a component in a larger software project 
in the future. 

If 90% of a new OOP software program consists of proven, existing components made from 
preexisting reusable objects, then only the remaining 10% of the new software project has to be 
written and tested from scratch. Since 90% already came from an inventory of extensively 
tested reusable objects, the potential domain from which an error could originate is 10% of the 
program. As a result, OOP enables software developers to build objects out of other, previously 
built, objects. 

This process closely resembles complex machinery being built out of assemblies and sub- 
assemblies. OOP technology, therefore, makes software engineering more like hardware 
engineering in that software is built from existing components, which are available to the 
developer as objects. All this adds up to an improved quality of the software as well as an 
increased speed of its development. 

Programming languages are beginning to fully support the OOP principles, such as 
encapsulation, inheritance, polymorphism, and composition-relationship. With the advent of 
the C++ language, many commercial software developers have embraced OOP. C++ is an OOP 
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language that offers a fast, machine-executable code. Furthermore, C++ is suitable for both 
commercial-application and systems-programming projects. For now, C++ appears to be the 
most popular choice among many OOP programmers, but there is a host of other OOP 
languages, such as Smalltalk, common lisp object system (CLOS), and Eiffel. Additionally, OOP 
capabilities are being added to more traditional popular computer programming languages 
such as Pascal. 

The benefits of object classes can be summarized, as follows: 

Objects and their corresponding classes break down complex programming problems 
into many smaller, simpler problems. 

Encapsulation enforces data abstraction through the organization of data into small, 

independent objects that can communicate with each other. Encapsulation protects the 

data in an object from accidental damage, but allows other objects to interact with that 

data by calling the object's member functions and structures. 

Subclassing and inheritance make it possible to extend and modify objects through 

deriving new kinds of objects from the standard classes available in the system. Thus, 

new capabilities are created without having to start from scratch. 

Polymorphism and multiple inheritance make it possible for different programmers to 

mix and match characteristics of many different classes and create specialized objects 

that can still work with related objects in predictable ways. 

Class hierarchies and containment hierarchies provide a flexible mechanism for 

modeling real-world objects and the relationships among them. 

Libraries of reusable classes are useful in many situations, but they also have some 

limitations. For example: 

Complexity. In a complex system, the class hierarchies lor relaced classes can become 
extremely confusing, with many dozens or even hundreds of classes. 
Flow of control A program written with the aid of class libraries is still responsible for 
the flow of control (i.e., it must control the interactions among all the objects created 
from a particular library). The programmer has to decide which functions to call at 
what times for which kinds of objects. 

Duplication of effort. Although class libraries allow programmers to use and reuse many 
small pieces of code, each programmer puts those pieces together in a different way. 
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Two different programmers can use the same set of class libraries to write two programs 
that do exactly the same thing but whose internal structure (i.e., design) may be quite 
different, depending on hundreds of small decisions each programmer makes along the 
way. Inevitably, similar pieces of code end up doing similar things in slightly different 
5 ways and do not work as well together as they should. 



Class libraries are very flexible. As programs grow more complex, more programmers are 
forced to reinvent basic solutions to basic problems over and over again. A relatively new 
extension of the class library concept is to have a framework of class libraries. This framework 
1 0 is more complex and consists of significant collections of collaborating classes that capture 
both the small scale patterns and major mechanisms that implement the common 
requirements and design in a specific application domain. They were first developed to free 
application programmers from the chores involved in displaying menus, windows, dialog boxes, 
and other standard user interface elements for personal computers. 

15 

Frameworks also represent a change in the way programmers think about the interaction 
between the code they write and code written by others. In the early days of procedural 
programming, the programmer called libraries provided by the operating system to perform 
certain tasks, but basically the program executed down the page from start to finish, and the 
20 programmer was solely responsible for the flow of control. This was appropriate for printing 

out paychecks, calculating a mathematical table, or solving other problems with a program that 
executed in just one way. 

The development of graphical user interfaces began to turn this procedural programming 
25 arrangement inside out. These interfaces allow the user, rather than program logic, to drive 
the program and decide when certain actions should be performed. Today, most personal 
computer software accomplishes this by means of an event loop which monitors the mouse, 
keyboard, and other sources of external events and calls the appropriate parts of the 
programmer's code according to actions that the user performs. The programmer no longer 
30 determines the order in which events occur. Instead, a program is divided into separate pieces 
that are called at unpredictable times and in an unpredictable order. By relinquishing control 
in this way to users, the developer creates a program that is much easier to use. Nevertheless, 
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individual pieces of the program written by the developer still call libraries provided by the 
operating system to accomplish certain tasks, and the programmer must still determine the 
flow of control within each piece after it's called by the event loop. Application code still "sits 
on top of the system. 

Even event loop programs require programmers to write a lot of code that should not need to be 
written separately for every application. The concept of an application framework carries the 
event loop concept further. Instead of dealing with all the nuts and bolts of constructing basic 
menus, windows, and dialog boxes and then making these things all work together, 
programmers using application frameworks start with working application code and basic user 
interface elements in place. Subsequently, they build from there by replacing some of the 
generic capabilities of the framework with the specific capabilities of the intended application. 

Application frameworks reduce the total amount of code that a programmer has to write from 
scratch. However, because the framework is really a generic application that displays windows, 
supports copy and paste, and so on, the programmer can also relinquish control to a greater 
degree than event loop programs permit. The framework code takes care of almost all event 
handling and flow of control, and the programmer's code is called only when the framework 
needs it (e.g., to create or manipulate a proprietary data structure). 

A programmer writing a framework program not only relinquishes control to the user (as is also 
true for event loop programs), but also relinquishes the detailed flow of control within the 
program to the framework. This approach allows the creation of more complex systems that 
work together in interesting ways, as opposed to isolated programs, having custom code, being 
created over and over again for similar problems. 

Thus, as is explained above, a framework basically is a collection of cooperating classes that 
make up a reusable design solution for a given problem domain. It typically includes objects 
that provide default behavior (e.g., for menus and windows), and programmers use it by 
inheriting some of that default behavior and overriding other behavior so that the framework 
calls application code at the appropriate times. 

There are three main differences between frameworks and class libraries: 
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Behavior versus protocol Class libraries are essentially collections of behaviors that you 
can call when you want those individual behaviors in your program. A framework, on 
the other hand, provides not only behavior but also the protocol or set of rules that 
govern the ways in which behaviors can be combined, including rules for what a 
5 programmer is supposed to provide versus what the framework provides. 

Call versus override. With a class library, the code the programmer instantiates objects 
and calls their member functions. It's possible to instantiate and call objects in the 
same way with a framework (i.e., to treat the framework as a class library), but to take 
full advantage of a framework's reusable design, a programmer typically writes code 
10 that overrides and is called by the framework. The framework manages the flow of 

control among its objects. Writing a program involves dividing responsibilities among 
the various pieces of software that are called by the framework rather than specifying 
how the different pieces should work together. 

Implementation versus design. With class libraries, programmers reuse only 
15 implementations, whereas with frameworks, they reuse design. A framework embodies 

the way a family of related programs or pieces of software work. It represents a generic 
design solution that can be adapted to a variety of specific problems in a given domain. 
For example, a single framework can embody the way a user interface works, even 
though two different user interfaces created with the same framework might solve quite 
20 different interface problems. 

Thus, through the development of frameworks for solutions to various problems and 
programming tasks, significant reductions in the design and development effort for software 
can be achieved. A preferred embodiment of the invention utilizes Hypertext Markup Language 

25 (HTML) to implement documents on the Internet together with a general- purpose secure 

communication protocol for a transport medium between the client and the merchant. HTTP or 
other protocols could be readily substituted for HTML without undue experimentation. 
Information on these products is available in T. Berners-Lee, D. Connoly, "RFC 1866: Hypertext 
Markup Language - 2.0" (Nov. 1995); and R. Fielding, H, Frystyk, T. Berners-Lee, J. Gettys and 

30 J.C. Mogul, "Hypertext Transfer Protocol- HTTP/ 1 . 1 : HTTP Working Group Internet Draft" (May 
2, 1996). HTML is a simple data format used to create hypertext documents that are portable 
from one platform to another. HTML documents are SGML documents with generic semantics 
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that are appropriate for representing information from a wide range of domains. HTML has 
been in use by the World-Wide Web global information initiative since 1990. HTML is an 
application of ISO Standard 8879:1986 Information Processing Text and Office Systems; 
Standard Generalized Markup Language (SGML). 

5 

To date, Web development tools have been limited in their ability to create dynamic Web 
applications which span from client to server and interoperate with existing computing 
resources. Until recently, HTML has been the dominant technology used in development of 
Web-based solutions. However, HTML has proven to be inadequate in the following areas: 
10 o Poor performance; 

o Restricted user interface capabilities; 
o Can only produce static Web pages; 

o Lack of interoperability with existing applications and data; and 
o Inability to scale. 

15 

Sun Microsystem's Java language solves many of the client-side problems by: 
o Improving performance on the client side; 

o Enabling the creation of dynamic, real-time Web applications; and 

o Providing the ability to create a wide variety of user interface components. 

20 

With Java, developers can create robust User Interface (UI) components. Custom "widgets" (e.g. 
real-time stock tickers, animated icons, etc.) can be created, and client-side performance is 
improved. Unlike HTML, Java supports the notion of client-side validation, offloading 
appropriate processing onto the client for improved performance. Dynamic, real-time Web 
25 pages can be created. Using the above-mentioned custom UI components, dynamic Web pages 
can also be created. 

Sun's Java language has emerged as an industry-recognized language for "programming the 
Internet." Sun defines Java as: "a simple, object-oriented, distributed, interpreted, robust, 
30 secure, architecture-neutral, portable, high-performance, multithreaded, dynamic, buzzword- 
compliant, general-purpose programming language. Java supports programming for the 
Internet in the form of platform-independent Java applets/ Java applets are small, specialized 
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applications that comply with Sun's Java Application Programming Interface (API) allowing 
developers to add "interactive content" to Web documents (e.g. simple animations, page 
adornments, basic games, etc.). Applets execute within a Java-compatible browser (e.g. 
Netscape Navigator) by copying code from the server to client. From a language standpoint, 
5 Java's core feature set is based on C++. Sun's Java literature states that Java is basically 
"C++, with extensions from Objective C for more dynamic method resolution". 

Another technology that provides similar function to JAVA is provided by Microsoft and ActiveX 
Technologies, to give developers and Web designers wherewithal to build dynamic content for the 

1 0 Internet and personal computers. ActiveX includes tools for developing animation, 3-D virtual 
reality, video and other multimedia content. The tools use Internet standards, work on multiple 
platforms, and are being supported by over 100 companies. The group's building blocks are 
called ActiveX Controls, small, fast components that enable developers to embed parts of software 
in hypertext markup language (HTML) pages. ActiveX Controls work with a variety of 

1 5 programming languages including Microsoft Visual C++ , Borland Delphi , Microsoft Visual Basic 
programming system and, in the future, Microsoft's development tool for Java, code named 
"Jakarta." ActiveX Technologies also includes ActiveX Server Framework, allowing developers to 
create server applications. One of ordinary skill in the art readily recognizes that ActiveX could be 
substituted for JAVA without undue experimentation to practice the invention. 

20 

Figure IB depicts an overview of the present invention. Customer computer system 120 is in 
communication with merchant computer system 130. The customer-merchant session 150 
operates under a general-purpose secure communication protocol such as the SSL protocol. 
Merchant computer system 130 is additionally in communication with payment gateway 

25 computer system 140. A payment gateway is a system that provides electronic commerce 

services in support of a bank or other financial institution, and that interfaces to the financial 
institution to support the authorization and capture of transactions. The customer-institution 
session 170 operates under a variant of a secure payment technology such as the SET protocol, 
as described herein, referred to as Merchant-Originated Secure Electronic Transactions 

30 ("MOSET'), as is more fully described herein. 



Customer- to-Merchant Communication 
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Figure 2 depicts a more detailed view of customer computer system 120 in communication with 
merchant system 130 using customer-merchant session 150 operating under the SSL protocol 
as documented in Freier and incorporated by reference. 

Customer computer system 120 initiates communication with merchant computer system 130 
using any well-known access protocol, e.g., Transmission Control Protocol/ Internet Protocol 
(TCP/IP"). A description of TCP/IP is provided in Information Sciences Institute, "Transmission 
Control Protocol DARPA Internet Program Protocol Specification (RFC 793)" (September, 198 1 ), 
and Information Sciences Institute, "Internet Protocol DARPA Internet Program Protocol 
Specification (RFC 791)" (September, 1981). In this implementation, customer computer system 
120 acts as a client and merchant computer system 130 acts as a server. 

Customer computer system 120 initiates communication by sending "client hello" message 210 
to the merchant computer system 130. When a client first connects to a server it is required to 
send the client hello message 210 as its first message. The client can also send a client hello 
message 210 in response to a hello request on its own initiative in order to renegotiate the 
security parameters in an existing connection. The client hello message includes a random 
structure, which is used later in the protocol. Specifically, the random structure includes the 
current time and date in standard UNIX 32-bit format according to the sender s internal clock 
and twenty-eight bytes of data generated by a secure random number generator. The client 
hello message 210 further includes a variable length session identifier. If not empty, the 
session identifier value identifies a session between the same client and server whose security 
parameters the client wishes to reuse. The session identifier may be from an earlier 
connection, the current connection, or another currently active connection. It is useful to 
specify the current connection if the client only wishes to update the random structures and 
derived values of a connection. It is useful to specify another currently active connection if the 
client wishes to establish several simultaneous independent secure connections to the same 
server without repeating the full handshake protocol. Client hello message 210 further 
includes an indicator of the cryptographic algorithms supported by the client in order of the 
client's preference, ordered according to client preference. 
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In response to client hello message 210, if merchant computer system 130 wishes to 
correspond with customer computer system 120, it responds with server hello message 215. If 
merchant computer system 130 does not wish to communicate with customer computer 
system 120, it responds with a message, not shown, indicating refusal to communicate. 

5 

Server hello message 215 includes a random structure, which is used later in the protocol. 
The random structure in server hello message 215 is in the same format as, but has contents 
independent of, the random structure in client hello message 210. Specifically, the random 
structure includes the current time and date in standard UNIX 32-bit format according to the 

10 sender's internal clock and twenty-eight bytes of data generated by a secure random number 
generator. Server hello message 215 further includes a variable length session identifier. The 
session identifier value identifies a new or existing session between the same client and server. 
Server hello message 215 further includes an indicator of the cryptographic algorithms selected 
from among the algorithms specified by client hello message 210, which is utilized in further 

15 encrypted communications. 

Optionally, Merchant computer system 130 transmits a server certificate 220. If transmitted, 
server certificate 130 enables customer computer system 120 to authenticate the identity of 
merchant computer system 130. 

20 

If merchant computer system 130 does not transmit a server certificate 220, or if server 
certificate 220 is suitable only for authentication, it may optionally transmit a server key 
exchange message 225. Server key exchange message 225 identifies a key that may be used 
by customer computer system 120 to decrypt further messages sent by merchant computer 
25 system 130. 

After transmitting server hello message 215, and opuonally transmitting server certificate 220 
or server key exchange message 225, merchant computer system 130 transmits a server hello 
done message 230 and waits for a further response from customer computer system 120. 

30 

Customer computer system 120 opuonally transmits client certificate 240 to merchant 
computer system 130. If transmitted, client certificate 240 enables merchant computer system 
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130 to authenticate the identity of customer computer system 120. Alternatively, customer 
computer system 120 may transmit a no-client-certificate alert 245, to indicate that the 
customer has not registered with any certification authority. 

If customer computer system 130 does not transmit a client certificate 240, or if client 
certificate 240 is suitable only for authentication, customer computer system 130 may 
optionally transmit a client key exchange message 250. Client key exchange message 250 
identifies a key that may be used by merchant computer system 130 to decrypt further 
messages sent by customer computer system 120. 

After optionally transmitting client certificate 240, no- client-certificate alert 245. and /or client 
key exchange message 250, customer computer system 120 transmits a finished message 260. 

At this point, customer computer system 120 and merchant computer system 130 have: 

1) negotiated an encryption scheme that may be commonly employed in further 
communications, and 

2) have communicated to each other a set of encryption keys that may be used to decrypt 
further communications between the two computer systems. 

Customer computer system 120 and merchant computer system 130 may thereafter engage in 
secure communications 270 with less risk of interception by third parties. 

Among the messages communicated by customer computer system 120 to merchant computer 
system 130 may be messages that specify goods or services to be ordered and payment 
information, such as a credit card number and related information, collectively referred to as 
"payment information," that may be used to pay for the goods and/or services ordered. In 
order to obtain payment, the merchant must supply this information to the bank or other 
payment gateway responsible for the proffered payment method. This enables the merchant to 
perform payment authorization and payment capture. Payment authorization is the process by 
which permission is granted by a payment gateway operating on behalf of a financial institution 
to authorize payment on behalf of the financial institution. This is a process that assesses 
transaction risk, confirms that a given transaction does not raise the account holder s debt 
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above the account's credit limit, and reserves the specified amount of credit. Payment capture 
is the process that triggers the movement of funds from the financial institution to the 
merchant's account after settlement of the account. 

Payment Authorization 

Merchants utilize point-of-sale products for credit and debit transactions on a daily basis. An 
embodiment in accordance with the subject invention allows an acquirer processor to accept 
transactions from Internet storefronts without altering a current host environment. 
The system easily converts payment protocol messages and simultaneously manages 
transactions from a number of Internet merchant servers. As the number of transactions 
grows, the payment gateway can be scaled to handle the increased business, and it can be 
configured to work with specific business processes used by the acquirer/ processor. Thus, the 
payment gateway supports Internet processing utilizing payment processing operations. 

The payment gateway provides support for configuring and installing the Internet payment 
capability utilizing existing host point-of-sale technology. The payment gateway also provides 
an intuitive Graphical User Interface (GUI) with support built in to accommodate future 
payment instruments such as debit cards, electronic checks, electronic cash and 
micropayments. The payment gateway implements secure transactions using RSA public-key 
cryptography and the MasterCard/Visa Secure Electronic Transaction (SET) protocol. The 
gateway also provides full functionality for merchant payment processing including 
authorization, capture, settlement and reconciliation while providing monitor activity with 
reporting and tracking of transactions sent over the Internet. Finally, the payment gateway 
also implements Internet payment procedures that match current processor business models to 
ensure consistency for merchants. Handling Internet transactions is destined to become a 
necessary function for every payment processing system. Today, merchants often transmit 
data received over the Internet inefficiently. Some fax the information or waste time keying 
data into a non-Internet system. 

Figure 3 depicts an overview of the method of securely supplying payment information to a 
payment gateway in order to obtain payment authorization. In function block 310, merchant 
computer system 130 generates a payment authorization request 315 and transmits it to 
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payment gateway computer system 140. In function block 330, payment gateway system 140 
processes the payment authorization request, generates a payment authorization response 325 
and transmits it to merchant computer system 130. In function block 320, merchant 
computer system 130 processes payment authorization response 325 and determines whether 
5 payment for the goods or services sought to be obtained by the customer has been authorized. 

Payment Authorization Request Generation 

Figure 4 depicts the detailed steps of generating and transmitting a payment authorization 
request. Figures 5A through 5F depict views of the payment authorization request and its 

10 component parts. In function block 410, merchant computer system 130 creates a basic 

authorization request 510. The basic authorization request is a data area that includes all the 
information for determining whether a request should be granted or denied. Specifically, it 
includes such information as the party who is being charged, the amount to be charged, the 
account number of the account to be charged, and any additional data, such as passwords, 

1 5 needed to validate the charge. This information is either calculated based upon prior customer 
merchandise selection, or provided by the customer over the secure link 270 established in the 
customer-merchant general* purpose secure communication protocol session. Fig 5A depicts a 
basic authorization request 510. 

20 In function block 420, merchant computer system 130 combines basic authorization request 
510, a copy of its encryption public key certificate 515 and a copy of its signature public key 
certificate 520. Merchant computer system 130 calculates a digital signature 525 for the 
combined contents of the combined block 530 comprising basic authorization request 510, the 
encryption public key certificate 515 and the signature public key certificate 520, and appends 

25 it to the combination of the combined basic authorization request 510, the encryption public 
key certificate 515 and the signature public key certificate 520. The merchant computer 
system calculates digital signature 525 by first calculating a "message digest" based upon the 
contents of the combined basic authorization request 510, the encryption public key certificate 
515 and the signature public key certificate 520. A message digest is the fixed-length result 

30 that is generated when a variable length message is fed into a one-way hashing function. 

Message digests help verify that a message has not been altered because altering the message 
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would change the digest. The message digest is then encrypted using the merchant computer 
system's 130 digital signature private key, thus forming a digital signature. 

Figure SB depicts the combined block 530 formed by function block 420 and containing basic 
5 authorization request 510, the encryption public key certificate 515, the signature public key 
certificate 520, and digital signature 525. 

In function block 430, merchant computer system 130 generates a random encryption key RK- 
0 540, denoted as RK-O. Random encryption key RK-0 540 is a symmetric encryption key. A 
10 symmetric encryption key is a key characterized by the property that a message encrypted with 
a symmetric key can be decrypted with that same key. This is contrasted with an asymmetric 
key pair, such as a public-key/ private-key key pair, where a message encrypted with one key of 
the key pair may only be decrypted with the other key of the same key pair. Figure 5C depicts 
random encryption key RK-0 540. 

15 

In function block 440, merchant computer system 130 encrypts combined block 530 using 
random encryption key RK-0 540 to form encrypted combined block 550. Figure 5D depicts 
encrypted combined block 550. The encryption state of encrypted combined block 550 is 
graphically shown by random key lock 555, which indicates that encrypted combined block 
20 550 is encrypted using random key RK-0 540. 

In function block 450, merchant computer system 130 encrypts random encryption key RK-0 
540 using the public key of payment gateway system 140 to form encrypted random key 560. 
Figure 5E depicts encrypted random key 560. The encryption state of encrypted random key 
25 560 is graphically shown by payment gateway public key lock 565, which indicates that 
encrypted random key 560 is encrypted using the payment gateway public key. 

In function block 460, merchant computer system 130 concatenates encrypted combined block 
550 and encrypted random key 560 to form merchant authorization request 315. Figure 5F 
30 depicts merchant authorization request 315 comprising encrypted combined block 550 and 
encrypted random key 560. In function block 470, merchant computer system 130 transmits 
merchant authorization request 315 to payment gateway system 140. 
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Payment Authorization Request Processing 

Figure 6 depicts the detailed steps of processing a payment authorization request and 
5 generating and transmitting a payment authorization request response. Function blocks 610 
through 630 depict the steps of processing a payment authorization, request, while function 
blocks 63S through 685 depict the steps of generating and transmitting a payment 
authorization request response. 

10 In function block 610, payment gateway computer system 140 applies its private key to 
encrypted random key 560 contained within received merchant authorization request 315. 
thereby decrypting it and obtaining a cleartext version of random key RK-0 540. In function 
block 615, payment gateway computer system 140 applies random key RK-0 540 to encrypted 
combined block 550, thereby decrypting it and obtaining a cleartext version of combined block 

15 530. Combined block 530 comprises basic authorization request 510, a copy of merchant 

computer system's 130 encryption public key certificate 515 and a copy of merchant computer 
system's 130 signature public key certificate 520, as well as merchant digital signature 525. 

In function block 620, payment gateway computer system 140 verifies merchant computer 
20 system's 130 encryption public key certificate 515 and merchant computer system's 130 
signature public key certificate 520. Payment gateway computer system 140 performs this 
verification by making a call to the certification authorities associated with each certificate. If 
verification of either certificate fails, payment gateway computer system 140 rejects the 
authorization request. 

25 

In function block 625, payment gateway computer system 140 validates merchant digital 
signature 525. Payment gateway computer system 140 performs this validation by calculating 
a message digest over the contents of the combined basic authorization request 510, the 
encryption public key certificate 515 and the signature public key certificate 520. Payment 
30 gateway computer system 140 then decrypts digital signature 525 to obtain a copy of the 

equivalent message digest calculated by merchant computer system 130 in function block 420. 
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If the two message digests are equal, the digital signature 525 is validated. If validation fails, 
payment gateway computer system 140 rejects the authorization request. 

In function block 630, payment gateway computer system 140 determines the financial 
institution for which authorization is required by inspection of basic authorization request 510. 
Payment gateway computer system 140 contacts the appropriate financial institution using a 
secure means, e.g, a direct-dial modem-to-modem connection, or a proprietary internal network 
that is not accessible to third parties, and using prior art means, obtains a response indicating 
whether the requested payment is authorized. 

Payment Authorization Response Generation 

Function blocks 635 through 685 depict the steps of generating and transmitting a payment 
authorization request response. Figures 7A through 7 J depict views of the payment 
authorization response and its component parts. 

In function block 635, payment gateway computer system 140 creates a basic authorization 
response 710. The basic authorization request is a data area that includes all the information 
to determine whether a request was granted or denied. Figure 7A depicts basic authorization 
response 710. 

In function block 640, payment gateway computer system 140 combines basic authorization 
response 710, and a copy of its signature public key certificate 720, Payment computer system 
140 calculates a digital signature 725 for the combined contents of the combined block 730 
comprising basic authorization response 710 and the signature public key certificate 720, and 
appends the signature to the combination of the combined basic authorization response 710 
and the signature public key certificate 720. The payment gateway computer system 
calculates digital signature 725 by first calculating a message digest based on the contents of 
the combined basic authorization response 710 and signature public key certificate 720. The 
message digest is then encrypted using the merchant computer system's 140 digital signature 
private key, thus forming a digital signature. 
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Figure 7B depicts the combined block 730 formed in function block 640 and containing basic 
authorization response 710, the signature public key certificate 720, and digital signature 725. 

In function block 645, payment gateway computer system 150 generates a first symmetric 
5 random encryption key 740, denoted as RK-1. Figure 7C depicts first random encryption key 
RK-1 740. 

In function block 650, payment gateway computer system 140 encrypts combined block 730 
using random encryption key RK-1 740 to form encrypted combined block 750. Figure 7D 
1 0 depicts encrypted combined block 750. The encryption state of encrypted combined block 750 
is graphically shown by random key lock 755, which indicates that encrypted combined block 
750 is encrypted using random key RK-1 740. 

In function block 655, payment gateway computer system 140 encrypts random encryption 
1 5 key RK-1 740 using the public key of merchant computer system 130 to form encrypted 

random key RK 760. Figure 7E depicts encrypted random key RK-1 760. The encryption state 
of encrypted random key 760 is graphically shown by merchant public key lock 765, which 
indicates that encrypted random key 760 is encrypted using the merchant public key. 

20 In function block 660, payment gateway computer system 140 generates a random capture 
token 770. Random capture token 770 is utilized in subsequent payment capture processing 
to associate the payment capture request with the payment authorization request being 
processed. Figure 7F depicts capture token 775. 

25 In function block 665, payment gateway computer system 140 generates a second symmetric 
random encryption key 775, denoted as RK-2. Figure 7G depicts second random encryption 
key RK-2 775. 



30 



In function block 670, payment gateway computer system 140 encrypts capture token 770 
using random encryption key RK-2 770 to form encrypted capture token 780. Figure 7H 
depicts encrypted capture token 780. The encryption state of encrypted capture token 780 is 



WO 98/05011 



PCT/US97/13673 



-30- 



graphically shown by random key lock 785, which indicates that encrypted capture token 780 
is encrypted using random key RK-2 770. 

In function block 675, payment gateway computer system 140 encrypts second random 
5 encryption key RK-2 775 using its own public key to form encrypted random key RK-2 790. 
Figure 71 depicts encrypted random key RK-2 790. The encryption state of encrypted random 
key 790 is graphically shown by payment gateway public key lock 795, which indicates that 
encrypted random key 790 is encrypted using the payment gateway public key. 

10 In function block 680, payment gateway computer system 140 concatenates encrypted 
combined block 750, encrypted random key RK-1 760, encrypted capture token 780 and 
encrypted random key RK-2 790 to form merchant authorization response 325. Figure 7 J 
depicts merchant authorization response 325 comprising encrypted combined block 750, 
encrypted random key RK-1 760, encrypted capture token 780 and encrypted random key RK- 

15 2 790. In function block 685, payment gateway computer system 140 transmits merchant 
authorization response 325 to merchant system 130. 

Payment Authorization Response Processing 

Figure 8 depicts the detailed steps of processing a payment authorization response. In function 
20 block 810, merchant computer system 130 applies its private key to encrypted random key 

RK-1 760 contained within received merchant authorization response 325, thereby decrypting 
it and obtaining a cleartext version of random key RK-1 740. In function block 820, merchant 
computer system 130 applies random key RK-1 740 to encrypted combined block 750, thereby 
decry pting it and obtaining a cleartext version of combined block 730. Combined block 730 
25 comprises basic authorization response 710, a copy of payment gateway computer system's 

140 signature public key certificate 720, as well as payment gateway digital signature 725. In 
function block 830, merchant computer system 130 verifies payment gateway computer 
system's 140 signature public key certificate 720. Merchant computer system 130 performs 
this verification by making a call to the certification authority associated with the certificate. If 
30 verification of the certificate fails, merchant computer system 130 concludes that the 

authorization response is counterfeit and treats it though the authorization request had been 
rejected. 
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In function block 840, merchant computer system 130 validates payment gateway digital 
signature 725. Merchant computer system 130 performs this validation by calculating a 
message digest over the contents of the combined basic authorization request 710 and the 
signature public key certificate 720. Merchant computer system 130 then decrypts digital 
signature 725 to obtain a copy of the equivalent message digest calculated by payment gateway 
computer system 140 in function block 640. If the two message digests are equal, the digital 
signature 725 is validated. If validation fails, concludes that the authorization response is 
counterfeit and treats it though the authorization request had been rejected. 

In function block 850, merchant computer system 130 stores encrypted capture token 780 
and encrypted random key RK-2 790 for later use in payment capture. In function block 860, 
merchant computer system 130 processes the customer purchase request in accordance with 
the authorization response 710. If the authorization response indicates that payment in 
authorized, merchant computer system 130 fills the requested order. If the authorization 
response indicates that payment is not authorized, or if merchant computer system 130 
determined in function block 830 or 840 that the authorization response is counterfeit , 
merchant computer system 130 indicates to the customer that the order cannot be filled. 



Payment Capture 

Figure 9 depicts an overview of the method of securely supplying payment capture information 
to payment gateway 140 in order to obtain payment capture. In function block 910, merchant 
computer system 130 generates a merchant payment capture request 915 and transmits it to 
payment gateway computer system 140. In function block 930, payment gateway system 140 
processes the payment capture request 915, generates a payment capture response 925 and 
transmits it to merchant computer system 130. In function block 920, merchant computer 
system 130 processes payment capture response 925 and verifies that payment for the goods 
or services sought to be obtained by the customer have been captured. 

Payment Capture Request Generation 

Figure 10 depicts the detailed steps of generating and transmitting a payment capture request. 
Figures 11A through 11F depict views of the payment capture request and its component 
parts. In function block 1010, merchant computer system 130 creates a basic capture request 
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510. The basic capture request is a data area that includes all the information needed by 
payment gateway computer system 140 to trigger a transfer of funds to the merchant operating 
merchant computer system 130. 

5 Specifically, a capture request includes a capture request amount, a capture token, a date, 
summary information of the purchased items and a Merchant ID (MID) for the particular 
merchant. Figure 11A depicts basic authorization request 1110. 

In function block 1020, merchant computer system 130 combines basic capture request lllO, 
10 a copy of its encryption public key certificate 1115 and a copy of its signature public key 

certificate 1120. Merchant computer system 130 calculates a digital signature 1125 for the 
combined contents of the combined block 1130 comprising basic capture request 1110, the 
encryption public key certificate 1115 and the signature public key certificate 1120, and 
appends it to the combination of the combined basic capture request 1110, the encryption 
15 public key certificate 1115 and the signature public key certificate 1120. The merchant 

computer system calculates digital signature 1125 by first calculating a message digest over 
the contents of the combined basic capture request 1110, the encryption public key certificate 
1115 and the signature public key certificate 1120. The message digest is then encrypted 
using the merchant computer system's 130 digital signature private key, thus forming a digital 
20 signature. 

Figure 11B depicts the combined block 1130 formed by function block 1020 and containing 
basic capture request 1110, the encryption public key certificate 1115, the signature public 
key certificate 1120, and digital signature 1125. In function block 1030, merchant computer 

25 system 130 generates a random encryption key 1140, denoted as RK-3. Random encryption 
key RK-3 1140 is a symmetric encryption key. Figure 11C depicts random encryption key RK- 
3 1140. In function block 1040, merchant computer system 130 encrypts combined block 
1130 using random encryption key RK-3 1140 to form encrypted combined block 1150. 
Figure 11D depicts encrypted combined block 1150. The encryption state of encrypted 

30 combined block 1150 is graphically shown by random key lock 1155, which indicates that 

encrypted combined block 1150 is encrypted using random key RK-3 1140. In function block 
1050, merchant computer system 130 encrypts random encryption key RK-3 1140 using the 
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public key of payment gateway system 140 to form encrypted random key 1160. Figure HE 
depicts encrypted random key 1160. The encryption state of encrypted random key 1160 is 
graphically shown by payment gateway public key lock 1165, which indicates that encrypted 
random key RK-3 1160 is encrypted using the payment gateway public key. 

5 

In function block 1060, merchant computer system 130 concatenates encrypted combined 
block 1150, encrypted random key 1160, and the encrypted capture token 780 and encrypted 
random key RK-2 790 that were stored in function block 850 to form merchant capture 
request 915. Figure 11F depicts merchant capture request 915, comprising encrypted 
10 combined block 1150, encrypted random key 1160, encrypted capture token 780 and 

encrypted random key RK-2 790. In function block 1070, merchant computer system 130 
transmits merchant capture request 915 to payment gateway system 140. 



Payment Capture Request Processing 

1 5 Figure 12 depicts the detailed steps of processing a payment capture request and generating 
and transmitting a payment capture request response. Function blocks 1210 through 1245 
depict the steps of processing a payment capture request, while function blocks 1250 through 
1285 depict the steps of generating and transmitting a payment capture request response. In 
function block 1210, payment gateway computer system 140 applies its private key to 

20 encrypted random key 1160 contained within received merchant capture request 915, thereby 
decrypting it and obtaining a cleartext version of random key RK-3 1140. In function block 
1215, payment gateway computer system 140 applies random key RK-3 1140 to encrypted 
combined block 1150, thereby decrypting it and obtaining a cleartext version of combined 
block 1130. Combined block 1130 comprises basic capture request 1110, a copy of merchant 

25 computer system's 130 encryption public key certificate 1115 and a copy of merchant 
computer system's 130 signature public key certificate 1120, as well as merchant digital 
signature 1125. In function block 1220, payment gateway computer system 140 verifies 
merchant computer system's 130 encryption public key certificate 1115 and merchant 
computer system's 130 signature public key certificate 1120. Payment gateway computer 

30 system 140 performs this verification by making a call to the certification authorities 

associated with each certificate. If verification of either certificate fails, payment gateway 
computer system 140 rejects the capture request. 
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In function block 1225, payment gateway computer system 140 validates merchant digital 
signature 1125. Payment gateway computer system 140 performs this validation by 
calculating a message digest over the contents of the combined basic capture request 1110, the 
5 encryption public key certificate 1115 and the signature public key certificate 1120. Payment 
gateway computer system 140 then decrypts digital signature 1125 to obtain a copy of the 
equivalent message digest calculated by merchant computer system 130 in function block 
1020. If the two message digests are equal, the digital signature 1125 is validated. If 
validation fails, payment gateway computer system 140 rejects the capture request. In 

10 function block 1230, payment gateway computer system 140 applies its private key to 

encrypted random key RK-2 790 contained within received merchant capture request 915, 
thereby decrypting it and obtaining a cleartext version of random key RK-2 775. In function 
block 1235, payment gateway computer system 140 applies random key RK-2 775 to 
encrypted capture token 780, thereby decrypting it and obtaining a cleartext version of capture 

15 token 770. 

In function block 1240, payment gateway computer system 140 verifies that a proper 
transaction is being transmitted between capture token 780 and capture request 1110. A 
capture token contains data that the gateway generates at the time of authorization. When the 

20 authorization is approved, the encrypted capture token is given to the merchant for storage. At 
the time of capture, the merchant returns the capture token to the gateway along with other 
information required for capture. Upon receipt of the capture token, the gateway compares a 
message made of the capture request data and the capture token data and transmits this 
information over a traditional credit/ debit network. If an improperly formatted transaction is 

25 detected, payment gateway computer system 140 rejects the capture request. In function 
block 1245, payment gateway computer system 140 determines the financial institution for 
which capture is requested by inspection of basic capture request 1110. Payment gateway 
computer system 140 contacts the appropriate financial institution using a secure means, e.g, 
a direct-dial modem-to-modem connection, or a proprietary internal network that is not 

30 accessible to third parties, and using prior art means, instructs a computer at the financial 
institution to perform the requested funds transfer after settlement. 



WO 98/05011 



-35- 



PCT/US97/13673 



Payment Capture Response Generation 

Function blocks 1250 through 1285 depict the steps of generating and transmitting a payment 
capture request response. Figures 13A through 13F depict views of the payment capture 
response and its component parts. 

5 

In function block 1250, payment gateway computer system 140 creates a basic capture 
response 710. The basic capture request is a data area that includes all the information to 
indicate whether a capture request was granted or denied. Figure 13A depicts basic 
authorization request 1310. 

10 

In function block 1255, payment gateway computer system 140 combines basic capture 
response 1310, and a copy of its signature public key certificate 1320. Payment computer 
system 140 calculates a digital signature 1325 for the combined contents of the combined 
block 1330 comprising basic capture response 1310 and the signature public key certificate 

15 1320, and appends the signature to the combination of the combined basic authorization 

request 1310 and the signature public key certificate 1320. The payment gateway computer 
system calculates digital signature 1325 by first calculating a message digest over the contents 
of the combined basic capture response 1310 and signature public key certificate 720. The 
message digest is then encrypted using the merchant computer system's 140 digital signature 

20 private key, thus forming a digital signature. 

Figure 13B depicts the combined block 1330 formed by function block 1255 and containing 
basic capture request 1310, the signature public key certificate 1320, and digital signature 
1325. In function block 1260, payment gateway computer system 140 generates a symmetric 

25 random encryption key 1340, denoted as RK-4. Figure 13C depicts random encryption key RK- 
4 1340. In function block 1275, payment gateway computer system 140 encrypts combined 
block 1330 using random encryption key RK-4 1340 to form encrypted combined block 1350. 
Figure 13D depicts encrypted combined block 1350. The encryption state of encrypted 
combined block 1350 is graphically shown by random key lock 1355, which indicates that 

30 encrypted combined block 1350 is encrypted using random key RK-4 1340. In function block 
1275, payment gateway computer system 140 encrypts random encryption key RK-4 1340 
using the public key of merchant computer system 130 to form encrypted random key RK-4 
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1360. Figure 13E depicts encrypted random key RK-4 1360. The encryption state of 
encrypted random key 1360 is graphically shown by merchant public key lock 1365, which 
indicates that encrypted random key 1360 is encrypted using the merchant public key. In 
function block 1280, payment gateway computer system 140 concatenates encrypted 
combined block 1350 and encrypted random key RK-4 1360 to form merchant capture 
response 925. Figure 13F depicts merchant capture response 925 comprising encrypted 
combined block 1350 and encrypted random key RK-4 1360. In function block 1285, 
payment gateway computer system 140 transmits merchant capture response 925 to merchant 
system 130. 



Payment Capture Response Processing 

Figure 14 depicts the detailed steps of processing a payment capture response. In function 
block 1410, merchant computer system 130 applies its private key to encrypted random key 
RK-4 1360 contained within received merchant capture response 925, thereby decrypting it 

15 and obtaining a cleartext version of random key RK-4 1340. In function block 1420, merchant 
computer system 130 applies random key RK-4 1340 to encrypted combined block 1350, 
thereby decrypting it and obtaining a cleartext version of combined block 1330. Combined 
block 1330 comprises basic capture response 1310, a copy of payment gateway computer 
system's 140 signature public key certificate 1320, as well as payment gateway digital 

20 signature 1325. In function block 1430, merchant computer system 130 verifies payment 
gateway computer system's 140 signature public key certificate 1320. Merchant computer 
system 130 performs this verification by making a call to the certification authority associated 
with the certificate. If verification of the certificate fails, merchant computer system 130 
concludes that the capture response is counterfeit and raises an error condition. 

25 

In function block 1440, merchant computer system 130 validates payment gateway digital 
signature 1325. Merchant computer system 130 performs this validation by calculating a 
message digest over the contents of the combined basic authorization request 1310 and the 
signature public key certificate 1320. Merchant computer system 130 then decrypts digital 
30 signature 1325 to obtain a copy of the equivalent message digest calculated by payment 

gateway computer system 140 in function block 1255. If the two message digests are equal, 
the digital signature 1325 is validated. If validation fails, merchant computer system 130 
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concludes that the authorization response is counterfeit and raises an error condition. In 
function block 1450, merchant computer system 130 stores capture response for later use in 
by legacy system accounting programs, e.g. to perform reconciliation between the merchant 
operating merchant computer system 130 and the financial institution from whom payment 
was requested, thereby completing the transaction. The system of the present invention 
permits immediate deployment of a secure payment technology architecture such as the SET 
architecture without first establishing a public-key encryption infrastructure for use by 
consumers. It thereby permits immediate use of SET-compliant transaction processing without 
the need for consumers to migrate to SET-compliant application software. 



VIRTUAL POINT OF SALE (vPOS) DETAILS 

A Virtual Point of Sale (vPOS) Terminal Cartridge is described in accordance with a preferred 
embodiment. The vPOS Terminal Cartridge provides payment functionality similar to what a 
VeriFone POS terminal ("gray box") provides for a merchant today, allowing a merchant to 
15 process payments securely using the Internet. It provides full payment functionality for a 
variety of payment instruments. 

Payment Functionality 

Figure 15A illustrates a payment processing flow in accordance with a preferred embodiment. 
The payment functionality provided by the vPOS terminal is divided into two main categories: 

20 "Merchant-Initiated* 1510 and "Consumer-Initiated" 1500. Some payment transactions 

require communication with the Acquirer Bank through the Gateway 1530. The normal flow of 
a transaction is via the vPOS Cartridge API 1512 to the vPOS C++ API 1514 into the payment 
protocol layer 1516 which is responsible for converting into the appropriate format for 
transmission to the Gateway for additional processing and forwarding to existing host payment 

25 authorization systems. Host legacy format refers to an existing authorization system for credit 
card approval currently utilized with the VeriFone Point of Sale (POS) gray terminals. The 
output from the payment protocol layer 1516 is transmitted to the authorization processing 
center via the gateway 1530. These transactions are referred to as "Online Transactions" or 
"Host Payments." The transactions that can be done locally by the merchant without having to 

30 communicate with the Acquirer Bank are referred to as "Local Functions and Transactions. " To 
support different types of payment instruments, the vPOS Terminal payment functionality is 
categorized as set forth below. 
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• Host Payment Functionality: These transactions require communication with the final 
host, either immediately or at a later stage. For example, an Online Authorization-Only 
transaction, when initiated, communicates with the host immediately. However, an Off-line 

5 Authorization-Only transaction is locally authorized by the vPOS terminal without having to 

communicate with the host, but at a later stage this off-line authorization transaction is 
sent to the host. Within the Host Payment Functionality some transactions have an 
associated Payment Instrument, while others do not. These two kinds of transactions are: 

• Host Financial Payment Functionality: These transactions have a Payment Instrument 
10 (Credit Card, Debit Card, E-Cash, E-Check, etc.) associated with them. For example, the 

"Return* transaction, which is initiated upon returning a merchandise to the merchant. 

• Host Administrative Payment Functionality: These transactions do not require a 
payment instrument, and provide either administrative or inquiry functionality. Examples 
of these transactions are "Reconcile* or the "Batch Close." 

15 • Local Functions and Transactions: These transactions do not require communication with 
the host at any stage, and provide essential vPOS terminal administrative functionality. An 
example of this is the vPOS terminal configuration function, which is required to set up the 
vPOS terminal. Another example is the VPOS Batch Review' function, which is required to 
review the different transactions in the vPOS Batch or the Transaction Log. 

20 Payment Instruments 

A preferred embodiment of a vPOS terminal supports various Payment Instruments. A 
consumer chooses a payment based on personal preferences. Some of the Payment 
Instruments supported include: 

• Credit Cards 
25 • Debit Cards 

• Electronic Cash 

• Electronic Checks 

• Micro-Payments (electronic coin) 

• Smart Cards 



WO 98/05011 



•39- 



PCT/US97/13673 



URL Table 

The table below enumerates the URLs corresponding to the transactions supported by the vPOS 
Terminal Cartridge. Note that the GET method is allowed for all transactions; however, for 
transactions that either create or modify information on the merchant server, a GET request 
5 returns an HTML page from which the transaction is performed via a POST method. 



Transaction 



URL 



POST 



Access Control 



Host Financial Payment Functionality 

auth capture /vPOSt/mi/authcaptur allowed 
e/ 

auth capture /vPOSt/ci/authcapture allowed 

/ 

auth only /vPOSt/mi/authonly/ allowed 

auth only /vPOSt/ci/authonly/ allowed 

adjust /vPOSt/mi/adjust/ allowed 

forced post /vPOSt/mi/forcedpost/ allowed 

offline auth /vPOSt/mi/offlineauth/ allowed 

offline auth /vPOSt/ci/offlineauth/ allowed 

pre auth / vPOSt / mi / preauth / allowed 

pre auth comp /vPOSt/mi/preauthcom allowed 
P/ 

/vPOSt/mi/return allowed 



return 

return 
void 



/vPOSt/ci/return/ allowed 
/ vPOSt/ mi/ void/ allowed 



merchant 
login/password 
no access control 

merchant 
login/password 
no access control 
merchant 
login /password 
merchant 
login /password 
merchant 
login /password 
no access control 
merchant 
login/ password 
merchant 
login /password 
merchant 
login/ password 
no access control 
merchant 
login /pas sword 
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host logon 

parameter 

download 

reconcile 



test host 



HOST ADMINISTRATIVE PAYMENT FUNCTIONALITY 

balance inquiry /vPOSt/mi/bi/ not allowed merchant 

login/ password 
/vPOSt/mi/hostlogon/ allowed merchant 

login /password 
/vPOSt/mi/parameters not allowed merchant 
dnld/ 

/ vPOS t / mi / reconcil e / allowed 



login/ password 
merchant 
login/password 
/vPOSt/mi/testhost/ not allowed merchant 

login/ password 



Local Functions & Transactions 

accum review /vPOSt/mi/accum/revi not allowed 
ew/ 

batch review /vPOSt/ mi/ batch/ revie not allowed 

w/ 

cdt review /vPOSt/ mi/ cdt/ review/ not allowed 



cdt update 
cpt review 
cpt update 



/ vPOSt / mi/ cdt / update allowed 

/ 

/vPOSt/mi/cpt/review not allowed 



/ vPOSt / mi / cpt / update allowed 

/ 

clear accum /vPOSt/ accum /clear/ allowed 

clear batch /vPOSt/ mi /batch /clear allowed 

/ 

hdt review / vPO St/ mi/ hdt/ review/ not allowed 



merchant 

login/ password 

merchant 

login/ password 

merchant 

login/ password 

merchant 

login/password 

merchant 

login/ password 

merchant 

login/ password 

merchant 

login /password 

merchant 

login/password 

merchant 

login/ password 
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hdt update 

lock vPOS 

query txn 
query txn 

tct review 

tct update 

unlock vPOS 



/ vPOSt / mi/ hdt / update allowed 

/ 



/vPOSt/mi/lock/ 



allowed 



/ vPOS t / ci/ querytxn / not allowed 

/vPOSt/mi/querytxn/ not allowed 

/vPOSt/mi/tct/review/ not allowed 

/ vPOSt/ mi/ tct / update / allowed 

/vPOSt/mi/unlock/ allowed 



merchant 
login/password 
merchant 
login/ password 
no access control 
merchant 
login/ password 
merchant 
login /password 
merchant 
login/ password 
merchant 
login/ password 



URL Descriptions 

This section describes the GET and POST arguments that are associated with each transaction 
URL. It also describes the results from the GET and POST methods. For URLs that produce 
any kind of results, the following fields are present in the HTML document that is returned by 
the vPOS Terminal Cartridge: 

txnDate Date of the transaction (mm/dd/yy or dd/mm/yy) 

txnTime Time of the transaction (hh:mm:ss GMT or hh:mm:ss local 
time) 

merchantld Merchant ID of the merchant using the vPOS terminal 

terminalld vPOS Terminal Id 

txnNum Transaction number of the given transaction 

txnType Type of transaction 

For URLs that deal with financial transactions, the following fields are present in the HTML 
document that is returned by the vPOS terminal cartridge: 



txnAmount Transaction amount that is being authorized, forced 
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posted, voided, etc. 
Purchase order number 
Authorization ID number for the transaction 

Retrieval reference number for the given transaction 
Payment instrument information. This varies for different 
payment instruments. For example, in the case of credit 
cards, the credit card number (piAcctNumber) and 
expiration date (piExpDate) are returned. 

Accumulate Review 

URL Functionality: This is a local information inquiry function that retrieves the local 
(merchant's) transaction totals (accumulators). 
GET Arguments: None. 

5 GET Results: Retrieves the transaction totals for the merchant. Currently, the total is returned 
as an HTML document. The transaction totals currently returned are: 

creditAmt Total Credit Amount since the last settlement logged in the 
vPOS terminal 

creditCnt Total Credit Count since the last settlement logged in the 

vPOS terminal 

debitAmt Total Debit Amount since the last settlement logged in the 

vPOS terminal 

debitCnt Total Debit Count since the last settlement logged in the 

vPOS terminal 

Note: Accum Review is a local function, as opposed to Balance Inquiry which is done over the 
10 Internet with the host. 

Adjust 

URL Functionality: Corrects the amount of a previously completed transaction. 
GET Arguments: None 



poNumber 

authldentNu 

m 

retRefNum 
pilnfo 
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GET Results: Because the Adjust transaction modifies data on the merchant server, the POST 
method should be used. Using the GET method returns an HTML form that uses the POST 
method to perform the transaction. 
POST Arguments: 

pvsTxnNum Previous transaction number 

txnAdjustedAmou The adjusted transaction amount. Note that the original 
nt transaction amount is easily retrievable from the 

previous transaction number. 

POST Results: On success, pvsTxnNum and txnAdjustedAmount are presented in the HTML 
document, in addition to the transaction fields described above. 



10 Auth Capture 

URL Functionality: This transaction is a combination of Auth Only (Authorization without 
capture) and Forced Post transactions. 
GET Arguments: None 

GET Results: Because the Auth Capture transaction modifies data on the merchant server 
15 side, the POST method should be used. Using the GET method returns an HTML form that 
uses the POST method to perform the transaction. 
POST Arguments: 

piAcctNumber Payment Instrument account number, e.g., Visa credit card 
number 

piExpDate Expiration date 
txnAmt Transaction amount 



20 POST Results: On success, an HTML document that contains the transaction fields described 
above is returned. On failure, an HTML document that contains the reason for the failure of the 
transaction is returned. The transaction is logged into a vPOS Terminal transaction log for both 
instances. 
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Auth Only 

URL Functionality: Validates the cardholder's account number for a Sale that is performed at 
a later stage. The transaction does not confirm the sale to the host, and there is no host data 
capture. The vPOS captures this transaction record and later forwards it to confirm the sale in 
5 the Forced Post transaction request. 
GET Arguments: None. 

GET Results: Because the Auth Only transaction modifies data on the merchant server side, 
the POST method should be used. Using the GET method returns an HTML form that uses the 
POST method to perform the transaction. 
1 0 POST Arguments: 

piAcctNumber Payment Instrument account number, e.g., Visa credit card 
number 

piExpDate Expiration date 
txnAmt Transaction amount 

POST Results: On success, an HTML document that contains the transaction fields is 
returned. On failure, an HTML document that contains the reason for the failure of the 
transaction is returned. The transaction is logged into vPOS Terminal transaction log for both 
1 5 instances. 

NOTE: The /vPOSt/ci/authonly/ URL should be used for customer-initiated transactions. 
/vPOSt/mi/authonly/ should be used for merchant-initiated transactions. 



Balance Inquiry 

20 URL Functionality: Performs an on-line inquiry or the merchant's balance. 
GET Arguments: None 
GET Results: 

mrchtBlnceA Merchant balance amount for a given merchant. The 
mt balance amount at any given time is the difference between 

the credit and debit amount since the test settlement 
between the merchant and the acquirer. 
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Batch Review 

URL Functionality: Retrieves all records from the transaction log or the batch. 
GET Arguments: None 

GET Results: The GET method retrieves the transactions that have been batched in the vPOS 
terminal for future reconciliation. The batch can be cleared from the vPOS terminal after a 
manual reconciliation between the acquirer and the vPOS. The batch data is retrieved as a set 
of records and is formatted as a table in the HTML document. The following fields are present 
in a typical record: 

nTransType Transaction type 

nPurchOrderNo Purchase order number 

szAcctNum Customer's payment instrument account number 

szExpDate Customer's payment instrument expiration date 

szTransAmt Transaction amount 

szTransDate Transaction date 

szTransTime Transaction time 

szRetrievalRefNu Transaction's retrieval reference number 
m 

szAuthld Authorization ID for the transaction 

szOrigAmt Original transaction amount 

szBatchNum Batch number for the given transaction 

nCurrencyType Currency in which the transaction was done 

InTransNum Transaction number 



CDT Review 

URL Functionality: Displays the vPOS terminal configuration data corresponding to the Card 
Definition Table (CDT). 
1 5 GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains the current 
configuration values. The form can be modified and posted using the / vPO St / mi /cat/ update/ 
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URL to update the card definition table. Not all fields in the card definition table are editable. 
The following fields are returned in a form to the user: 

nHostlndex Index into the Host Definition Table or the Acquirer that 

maps to this card issuer. 
szPANLo Low end of the PAN (Primary Account Number) range 

szPANHi High end of the PAN range 

nMaxPANDigit Maximum number of digits in the PAN for this acquirer. 
NMinPANDigit Minimum number of dits in the PAN for the acquirer 
szCard Label Card Issuer's name 

Transactions Specifies if a particular transaction is allowed for a given 

Available bit card range. 

vector 

5 (Some of these fields are not editable by a merchant, and still need to be determined.) 



CDT Update 

URL Functionality: Updates the vPOS terminal configuration data corresponding to the Card 

Definition Table (CDT). 
10 GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains the current 

configuration values. The form can be filled out and posted using the /vPOSt/mi/cdt/update 

URL to update the card definition table. 

POST Arguments: (Editable CDT fields need to be decided.) 
15 POST Results: (Depends on editable CDT fields, and therefore needs to be decided.) 



Clear Accumulator 

URL Functionality: Zeroes out the accumulator totals currently resident in the vPOS terminal. 
GET Arguments: None. 
20 GET Results: Presents a form that uses the POST method to zero the accumulators. 
POST Arguments: None. 
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POST Results: Zeroes the accumulators/ transaction totals in the vPOS terminal. 

Clear Batch 

URL Functionality: Zeroes out the transaction logs currently batched in the vPOS terminal. 
5 GET Arguments: None. 

GET Results: Presents a form that uses the POST method to clear the batch. 
POST Arguments: None. 

POST Results: Zeroes the transactions that comprise the batch in the vPOS terminal. 

10 Forced Post 

URL Functionality: Confirms to the host the completion of a sale, and requests for data 

capture of the transaction. This is used as a follow-up transaction after doing an Authorization 

(Online or Off-line) transaction. 

GET Arguments: None. 
15 GET Results: Returns the HTML form for performing the Forced Post transaction. 

POST Arguments: 

pvsTxnNum the previous transaction number from an auth only 
transaction 

POST Results: On success, pvsTxnNum is presented in the HTML document. On failure, an 
20 HTML document is returned that contains the reason for the failure of the transaction. 

HDT Review 

URL Functionality: Displays the vPOS terminal configuration data corresponding to the Host 
Definition Table (HDT). 
25 GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains the current 
configuration values. The form can be modified and posted using the /vPOSt/ mi/ hdt/ update 
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URL to update the hosts definition table. Not all fields in the host definition table are editable. 
The following fields are returned in a form to the user: 



szTennld 
szMerchld 
szCurrBatchNu 
m 

szTransNum 



szTPDU 
InSTAN 
szNII 

szHostName 

nHostType 

nNumAdv 

Data Capture 
Required Bit 
vector: 



Terminal ID for this vPOS terminal 
Merchant ID for this vPOS terminal 
Current batch number existing on the vPOS 

Reference number for the next transaction in the vPOS 
transaction log/batch. This is generated by vPOS and is 
not editable by the merchant. 

Transport Protocol Data Unit. Required for building the 
ISO 8583 packet. 

System trace number; message number of the next 

transaction to be transmitted to this acquirer. 

Network International Number. Required for building the 

ISO 8583 packet. 

Name for identifying the host. 

Host type 

Number of off-line transactions that can be piggy-backed 

at the end of an on-line transaction. 

Specifies for which transactions data capture is 

required. 



(Some of these fields are not editable by a merchant and need to be determined.; 



HDT Update 

URL Functionality: Updates the vPOS terminal configuration data corresponding to the Host 
Definition Table (HDT). 
GET Arguments: None 
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GET Results: The GET method returns a default HTML form that contains the current 
configuration values. The form can be filled out and posted to the merchant server using the 
/vPOSt/mi/hdt/update URL to update the host definition table 

Unlock vPOS 

URL Functionality: Local function that starts the vPOS at the start of the day. 
GET Arguments: None. 

GET Results: Returns an HTML form that uses the POST method to perform this transaction. 
POST Arguments: None. 

POST Results: Resets a Boolean flag on the merchant server that enables transactions to be 
accepted by the vPOS terminal. 

Offline Auth 

URL Functionality: This transaction is same as the "Authorization Only" transaction, except 
that the transaction is locally captured by the vPOS terminal without having to communicate 
with the host. A Forced Post operation is done as a follow-up operation of this transaction. 
GET Arguments: None. 

GET Results: Because the Offline Auth transaction modifies data on the merchant server side, 
the POST method should be used. Using the GET method returns an HTML form for using the 
POST method to perform the transaction. 
POST Arguments: 

piAcctNumber Payment Instrument account number, e.g., Visa credit card 
number 

piExpDate Expiration date 
txnAmt Transaction amount 

POST Results: On success, an HTML document that contains the transaction fields described 
in Section 4.1 is returned. On failure, an HTML document that contains the reason for the 
failure of the transaction is returned. The transaction is logged into vPOS terminal transaction 
log for both instances. 
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Parameter Download 

URL Functio nal ity: Downloads the vPOS configuration information from the host and sets up 
the vPOS in the event of the configuration data being changed. 
GET Arguments: None 

GET Results: Retrieves an HTML form that uses the POST method for the parameter download 
transaction. 

POST Arguments: None. 

POST Results: Downloads the following parameters from the host and uploads them into the 
vPOS terminal configuration table. 

• card/ issuer definition table (CDT) 

• host/ acquirer definition table (HDT) 

• communications parameter table (CPT) 

• terminal configuration table (TCT) 

The various configuration parameters can be reviewed and modified using the URLs for the 
desired functionality. 

Pre Auth 

URL Functionality: Used in lodging and hotel establishments to pre-authorize a charge that is 
completed some time in future. 
GET Arguments: None 

GET Results: Retrieves the HTML form for posting the pre- authorization transaction. 
POST Arguments: 

piAcctNumber Payment Instrument account number, e.g. , Visa credit card 
number 

piExpDate Expiration date 

Pre Auth Comp 

URL Functionality: Completes a pre -authorization transaction. 
GET Arguments: None 
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GET Results: Retrieves the HTML form for posting the pre-authorization completion 

transaction. 

POST Arguments: 

pvsTxnNum Previous transaction number from an auth only 
transaction 

POST Results: On success, pvsTxnNum is presented in the HTML document. On failure, an 
HTML document is returned that contains the reason for the failure of the transaction. 



Reconcile 

10 URL Functionality: This transaction is done at the end of the day to confirm to the host to 
start the settlement process for the transactions captured by the host for that particular vPOS 
batch. 

GET Arguments: None 

GET Results: Retrieves the HTML form for posting the Reconcile transaction. 
1 5 POST Arguments: None. 

POST Results: On success, the reconcile function prints any discrepancies in the merchant's 
batch of transactions and totals vis-a-vis the host's batch of transactions in totals. The output 
format is a combination of the output of the Batch Review and Accum Review transactions. 



20 Return 

URL Functionality: Credits the return amount electronically to the consumer's account when 

previously purchased merchandise is returned. The vPOS terminal captures the transaction 

record for this transaction. 

GET Arguments: None 
25 GET Results: Retrieves the HTML form for posting the Return transaction. 

POST Arguments: 



prevTxnNum 



Reference to the previous transaction number 
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The previous transaction has access to the following fields: 



txnArnount 



Transaction amount 



piAccountNu 



Payment instrument account number 



m 



piExpDate 



Payment instrument expiration date 



POST Results: On success, pvsTxnNum is presented in the HTML document, in addition to 



URL Functionality: Checks the presence of the host and also the integrity of the link from the 
vPOS to the host. 
GET Arguments: None. 

GET Results: On success, an HTML document is returned that reports success in connecting 
to the host. On failure, an HTML document is returned that reports the error encountered in 
testing the host. 



URL Functionality: This local function locks or stops the vPOS terminal from accepting any 

transactions. 

GET Arguments: None. 

GET Results: Returns an HTML form that posts the locking of the vPOS terminal. 
POST Arguments: None. 

POST Results: On success, an HTML document is returned that contains the status that vPOS 
terminal was successfully. On failure, an HTML document is returned that reports the cause of 
failure of the operation, e.g., access denied, the vPOS terminal is already locked or is presently 
processing a transaction, etc. 

Void 

URL Functionality: Cancels a previously completed draft capture transaction. 
GET Arguments: None. 



Test Host 



Lock vPOS 
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GET Results: Retrieves an HTML form for posting the Void transaction. 



POST Arguments: 



pvsTxnNum Transaction number from a previous Auth Only 
transaction. 



5 



Host Logon 



URL Functionality: Administrative transaction used to sign-on the vPOS with the host at the 
start of the day, and also to download encryption keys for debit transactions, 
GET Arguments: None 

GET Results: Retrieves an HTML form for posting the Host Logon transaction. 
1 0 POST Arguments: None. 

POST Results: Currently, debit card based transactions are not supported. The result is an 
HTML document indicating the success or failure of the host logon operation. 



URL Functio nali ty: Returns the vPOS terminal configuration data corresponding to the 
1 5 Communications Parameter Table (CPT). 
GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains the current 
configuration values corresponding to the vPOS terminal's communication parameters. The 
form can be filled out and posted to the merchant server using the /vPOSt/mi/cpt/ update URL 
20 to update the communications parameter table. The following fields are returned in a form to 
the user: 



CPT Review 



szAcqPriAddress 
szAcqSecAddress 
szActTerAddress 
nRespTimeOut 



Primary Host address 
Secondary Host address 
Tertiary Host address 

Time-out value (in seconds) before which the vPOS 
should receive a response from the host 
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CPT Update 



URL Functionality: Updates the vPOS terminal configuration data corresponding to the 
Communications Parameter Table (CPT). 
GET Arguments: None 
5 GET Results: The GET method returns a default HTML form that contains the current 
configuration values. The form can be modified and posted to update the communication 
parameter table. 
POST Arguments: 



POST Results: On success, the HTML document returned by the vPOS contains the values set 
by the merchant. On failure, the HTML document contains the reason for the failure of the 
invocation of the URL. 



1 5 URL Functionality: Returns the vPOS terminal configuration data corresponding to the 
Terminal Configuration Table (TCT). 
GET Arguments: None. 

GET Results: The GET method returns a default HTML form that contains the current 
configuration values. The form can be filled out and posted using the /vPOSt/ mi/ tct/ update 
20 URL to update the terminal configuration table. The following fields are returned in a form to 
the user: 



szAcqPriAddress 
szAcqSecAddress 
szActTerAddress 
nRespTimeOut 



Primary Host address 
Secondary Host address 
Tertiary Host address 

Time-out value (in seconds) before which the vPOS 
should receive a response from the host 



10 



TCT Review 



szMerchName 



Merchant name 



szSupervisorPwd 

fvPOSLock 

szAuthOnlyPwd 



Supervisor password 

1= vPOS locked, 0 = vPOS unlocked 

Password for initiating auth-only transaction 
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szAuthCaptPwd 

szAdjustPwd 

szRefundPwd 

szForcedPostPwd 

szOfflineAuthPwd 

szVoidPwd 

szPreAuthPwd 

szPreAuthCompP 

wd 



Password for initiating auth with capture transaction 

Password for adjust transaction 

Password for refund transaction 

Password for forced post transaction 

Password for offline auth transaction 

Password for void transaction 

Password for pre -authorization transaction 

Password for pre-authorization completion 



TCT Update 

URL Functionality: Updates the vPOS terminal configuration data corresponding to the 
Terminal Configuration Table (TCT). 
GET Arguments: None 

GET Results: The GET method returns a default HTML form that contains the current 
configuration values. The form can be filled out and posted using the / vPOSt / mi /tct/ update 
URL to update the terminal configuration table. 

POST Arguments: All arguments in TCT Review functionality are the returned values from the 
/vPOSt/mi/tct/update the URL. 



szMerchName 


Merchant name 


szSupervisorPwd 


Supervisor password 


fvPOSLock 


1= vPOS locked, 0 - vPOS unlocked 


szAuthOnlyPwd 


Password for initiating auth-only transaction 


szAuthCaptPwd 


Password for initiating auth with capture transaction 


szAdjustPwd 


Password for adjust transaction 


szRefundPwd 


Password for refund transaction 


szForcedPostPwd 


Password for forced post transaction 


szOfflineAuthPwd 


Password for offline auth transaction 


szVoidPwd 


Password for void transaction 


szPreAuthPwd 


Password for pre-authorization transaction 


szPreAuthCompP 


Password for pre-authorization completion 
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wd 

POST Results: On success, the POST modifies values of the terminal configuration table 
parameters. On failure, the HTML document contains the reason for the failure of the 
transaction. 

5 Query Transactions 

URL Functionality: Permits the merchant and customer to query a given transaction 
corresponding to a transaction number. 
GET Arguments: 

txnNum Transaction number 

1 0 GET Results: For a given transaction, the URL returns an HTML document. If a transaction 
refers to an older transaction, the transaction's entire history is made available. 

URL results 

Depending upon the method (GET/ POST) as well as the success or failure of the HTTP request, 
different documents are returned to the user. The vPOS terminal provides a framework 
15 whereby different documents are returned based upon a number of preferences. Currently the 
language and content-type are supported as preferences. 

A simple framework is proposed here. Each of the transaction has a set of documents 
associated with it: form for the payment transaction, GET success, GET failure, POST success, 
20 and POST failure. 

In the directory structure defined below, documents are stored corresponding to the 
preferences. The top level of the directory structure is the content-type, the next level is 
language (for NLS support). For example, to create text/html content in US English & French, 
25 the directory structure given below would contain the HTML documents for each of the 
transactions. The vPOS terminal cartridge has a configuration file that allows the user to 
specify the content-type as well as the language to be used for a cartridge. The first release of 
the vPOS terminal cartridge supports one content-type and language for each server. 



WO 98/05011 PCT/US97/13673 

- 57 - 



Data Structures & Functions 
Functions 

A brief description of the Virtual Point of Sale Terminal cartridge functions are provided below. 
vPOSTInit(), vPOSTExccfl and vPOSTShut() are the entry points required for each cartridge in 
5 accordance with a preferred embodiment. The other functions implement some of the key 
vPOST cartridge functionality. A source listing of the vPOS code is provided below to further 
accentuate the detailed disclosure of a preferred embodiment. 

vPOSTInit() 

/* vPOST cartridge Initialization here */ 
10 WRBReturnCode 

vPOSTInit( void "clientCtx ){ 
vPOSTCtx *vPOSTCxp ; 
/* Allocate memory for the client context */ 
if (!(vPOSTCxp = (vPOSTCtx *)malloc(sizeof(vPOSTCtx)))) 
15 return WRB.ERROR ; 

♦clientCtx = (void *)vPOSTCxp ; 
return (WRB_DONE) ;} 

vPOSTShut() 

WRBReturnCode 
20 vPOSTShut( void *WRBCtx, void 'clientCtx |{ 
*WRBCtx ; /* not used 7 
assert( clientCtx ) ; 

/• Free the client context allocated in vPOSTlnitCj routine 

free( clientCrt ) ; 

25 return (WRB.DONE) ;} 

vPOSTExec() 



/* The driver cartridge routine */ 
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WRBReturnCode 

vPOSTExec( void *WRBCtx, void 'clientCtx ) 

f 

vPOSTCtx *vPOSTCxp; 
char *uri ; 

char *txnMethod ; /* HTTP method 7 

enum evPOSTTxn *txn ; /* vPOST transaction */ 

char *txnOutFile ; /* Output file from transaction 7 

char **txnEnv ; /* environment variables values for transaction */ 

char *txnContent ; /* transaction's POST data content */ 

WRBEntry *WRBEntries ; 

int numEntries; 

vPOSTCxp = (vPOSTCtx *) clientCtx ; 

/* WRBGetURL gets the URL for the current request */ 

if (!(uri = WRBGetURL( WRBCtx ))) 

return (WRB_ERROR) ; 
/• WRBGetContent() gets the Query String/ POST data content */ 
if (!(txnContent = WRBGetContent( WRBCtx ))) ( 

return WRB.ERROR ; 

) 

/* WRBGetParserContentQ gets the parsed content */ 
if (WRB_ERROR «= WRBGEtParsedContent( WRBCU, fcWRBEntries, 
&numEntries)) j 

return WRB.ERROR ; 

i 

/* WRBGetEnvironmentQ gets the HTTP Server Environment *) 
if (!(txnEnv = WRBGetEnvironment( WRBCtx ))) ( 
return WRB_ERROR ; 

) 

/* vPOSTGetMethod() gets the method for the current request */ 
if ([(method = vPOSTGetMethod( txnEnv ))){ 
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return (WRB_ERROR) ; 

1 

/• vPOSTGetTxnQ gets the vPOST transaction for the request */ 
5 txn = vPOSTGetTxn( uri ); 

if (eTxnError == txn) ( 

return (WRB_ERROR) ; 

I 

10 /* vPOSTExecuteTransaction() executes the vPOST transaction 7 

txnOutFile = vPOSTExecuteTransaction( WRBCtx, txn, txnMethod, 

txnEnv, txnContent ) ; 
if (l(txnOutFile)) { 

return (WRB_ERROR) ; 

15 I 

/♦Write out the file */ 
vPOSTWriteFilef txnOutFile ) ; 
return (WRB.DONE) ; 

) 

20 vPOSTGetTxn() 

enum evPOSTTxn 
vPOSTGetTxn( char *uri ) 

/* 

25 * The function scans the uri and extracts the string 

* corresponding to the transaction and returns it to the 

* caller. 
V 

1 



30 



Transaction Log format 

This section describes the format of a record for the transaction log for the vPOST cartridge. 
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Field Name 



Field Description 



nTransType 

nPurchOrderNo 

szAcctNum 

szExpDate 

s2rtransAmt 

szTransDate 

szTransTime 

szRetrievalRefNum 

szAuthld 

szOrigAmt 

szBatchNum 

nCurrencyType 
InTransNum 



Transaction Type 

Purchase Order Number 

Payment Instrument Account number 

Payment instrument expiration date 

Transaction amount 

Date of transaction (configurable to be mm/dd/yy or dd/mm/yy) 

Time of transaction (configurable to be GMT or local time) 

Retrieval reference number 

Authorization ID 

Original transaction amount 

Batch number to which this particular transaction belongs in the 

vPOST batch 

Currency 

Transaction number 



In the block diagram shown in Figure 15B, the vPOS provides an interface for transactions 
5 which are initiated both by the consumer and the merchant. The merchant initiates a 
transaction from a Graphical User Interface (GUI) 1550 and all the transactions that are 
initiated by the consumer are routed by the Merchant WEB Server 1545. 

The Authorization/ Data Capture Module 1560 processes the requests originated by the 
10 merchant or the consumer and routes them to the Protocol Module 1565. The Protocol Module 
is responsible for building the payment protocol request packet (e.g., an SSL-encapsulated ISO 
8583 packet) 1570 before sending the request to the Gateway 1579. Then, the Gateway 1579 
awaits a response from the Protocol Module 1565, and upon receiving the response, the 
Gateway 1579 parses the data and provides unwrapped data to the Authorization/ Data- 
15 Capture Module 1560. The Authorization /Data-Capture Module 1560 analyzes the response 
and up ates the Transaction Log 1580. The Transaction Log 1580 contains information 
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concerning any successfully completed transactions and the accumulators or the transaction 
totals. The vPOS terminal creates and maintains the Transaction Log 1580, and the vPOS 
Configuration Data 1585 contains information which is used to configure the behavior of the 
vPOS. The entire vPOS functionality is thread-safe and hence using the vPOS in a multi- 
5 threaded environment does not require any additional interfacing requirements. 

Figures 36-48 are vPOS screen displays in accordance with a preferred embodiment. 

Payment Functionality 

10 As discussed above, the different Payment Functionality provided by the vPOS terminal can be 
divided into two main categories as "Merchant Initiated" and -Consumer initiated." Some of 
these transactions require communication with the Gateway and these transactions are 
referred to as "Online Transactions." The transactions which can be done locally to the 
merchant without having to communicate are referred to as "Local Functions /Transactions." 

15 In order to provide support for many different types of Payment Instruments, the vPOS 
Payment Functionality have been categorized. 

Host payment functionality and transactions require communication with the host either 
immediately or at a later stage. Each of the host financial payment transactions come to this 
20 category and require a Payment Instrument. These transactions can be initiated with different 
types of Payment Instruments which the vPOS terminal supports. 

An authorization without capture transaction is used to validate the card holder's account 
number for a sale that needs to be performed at a later stage. The transaction does not 
25 confirm a sale's completion to the host, and there is no host data capture in this event. The 
vPOS captures this transaction record and later forwards it to the host to confirm the sale in a 
forced post transaction request. An authorization without capture transaction can be initiated 
both by the consumer and the merchant. 

30 A forced post transaction confirms to a host computer that a completion of a sale has been 
accomplished and requests data capture of the transaction. The forced post transaction is 
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used as a follow-up transaction after doing an authorization (Online or Off-line) transaction. 
The transaction can be initiated only by the merchant. 

The authorization with post transaction is a combination of authorization without capture and 
5 forced post transactions. * This transaction can be initiated both by the consumer and the 
merchant. 

The offline post transaction is identical to the "authorization without capture" transaction, 
except that the transaction is locally captured by the vPOS without initiating communication 
10 with a host. A forced post operation is done as a follow-up operation of this transaction. This 
transaction can be initiated by both the consumer and the merchant. 

The return transaction is used to credit the return amount electronically to the consumer's 
account when a purchased merchandise is returned. The vPOS captures the return 
1 5 transaction record when the merchandise is returned, and this transaction can be initiated 
only by the merchant. 

The void transaction cancels a previously completed draft capture transaction. The vPOS GUI 
provides an interface for retrieving a transaction record required to be voided from the batch 
20 and passes it to the Authorization/ Data- Capture module after confirmation. The batch record 
is updated to reflect the voided transaction after getting an approval from the gateway. This 
transaction can be initiated only by the merchant. 

The pre-authorization transaction is identical to the authorization without capture transaction, 
25 but the consumers' "open- to- buy" amount is reduced by the pre-authorization amount. An 
example of this type of transaction is the "check-in" transaction in a hotel environment. A 
check-in transaction sends a pre-authorization request to the host, so that an amount required 
for the customers' stay in the hotel is reserved. The pre-authorization transaction is followed 
by a pre-authorization complete transaction. This transaction can be initiated both by the 
30 consumer and the merchant. 
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The pre-authorization complr 2 transaction is done as a follow-up to the pre-authorization 
transaction. This transaction informs the host of the actual transaction amount. The pre- 
authorization complete transaction amount could be more or less than the pre-authorization 
amount. An example is the -check-out" transaction in a hotel environment. The check-out 
5 amount can be less than or more than the check-in amount. This transaction can only be 
initiated by a merchant. 

The adjust transaction is initiated to make a correction to the amount of a previously 
completed transaction. The adjust transaction can be initiated only by the merchant. The host 
10 administrative transactions do not require any payment instrument. The balance inquiry 

transaction is used for on-line inquiry into the balance of the merchant's account. The batch 
data or the configuration data is not affected by this transaction. 

The reconciliation or close transaction is processed at the end of the day to start the settlement 
1 5 process for the transactions captured by the host for that particular vPOS. 

The host log-on transaction is an administrative transaction which is used to synchronize the 
vPOS with the host at the start of the day and also initiate a fresh batch at the vPOS terminal. 

20 The parameters download transaction is used to download the vPOS configuration information 
from the host and set-up the vPOS in the event of any change in the configuration data. A test 
transaction is used to detect the presence of a host and the status of a link from the vPOS to 
the host. 

25 Local transactions or functions are initiated by a merchant and do not require communication 
with the gateway. These transactions can only be initiated by a merchant. The totals or 
accumulators review is a local information inquiry function and is used to retrieve the local 
(merchant's) totals. The detail transaction or the batch review function is used to retrieve all 
the records from the transaction log or the batch. The clear batch function is used to start a 

30 fresh batch. This transaction is utilized to electronically reconcile the vPOS with the host and 
to manually reconcile the vPOS with the host. After completing the manual reconciliation 
processing, the merchant can initiate this transaction to start a fresh batch. 
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The clear accumulator function is similar to the clear batch functionality and resets all vPOS 
terminal accumulators to zero. This function is required when the merchant is not able to 
reconcile the vPOS with the host electronically. 

5 

The vPOS unlock or start transaction is a local function used to start the vPOS at the start of 
the day; The vPOS lock or stop function is used to Lock or stop the vPOS from accepting any 
transactions. The vPOS configuration setup function is used to setup the vPOS configuration 
data. The vPOS configuration data is divided into different tables, for example, the Card/ Issuer 
10 Definition Table (CDT), the Host/ Acquirer Definition Table (HDT), the Communications 

Parameters Table (CPT) and the Terminal Configuration Table (TCT). The following sections 
explain each of these configuration tables in detail. 

Host Definition Table (HDT) 

1 5 The table contains information specific to the acquirer. 



Field 


Attributes/ 
Bytes 


Field Description/Comments 


Terminal Identifier 


ANS(20) 


Terminal ID for this acquirer/ host 


Merchant Identifier 


ANS(20) 


Merchant ID for this acquirer/host 


Current Batch 
Number 


N(6) 


Batch Number for the batch currently existing 
on the vPOS 


Transaction 
Number 


1(2) 


Reference Number for next transaction in the 
vPOS transaction log/ batch (vPOS generated) 


TPDU 


AN(10) 


Transport Protocol Data Unit - Required for 
building the ISO 8583 packet. 


STAN 


L(4J 


Systems Trace Number - Message Number of 
the transaction to be transmitted next for this 
acquirer. 


Nil 


N(3) 


Network International Identifier - Required for 
building the ISO 8583 packet. 


Host Name or 
Label 


ANS(20) 


Name for identifying the host, e.g., "AMEX-SIN". 
This is only a text string and is used for the 
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purpose of identifying the host. 


No. of advice 
messages 


1(2) 


No. of off-line transactions (advice messages) 
that can be piggy-backed at the end of an on- 
line transaction. If set to zero then piggy- 
backing is disabled. 


The following fields sp 
acquirer. 


ecify whether Data Capture Required for a particular transaction fc 


Field 


M MA... »% 1»» / 

Attributes / 
Bytes 




Host Protocol Type 


1(2) 


Host Protocol type, e.g., ISO 8583, SET, etc., 


Host Protocol Sub- 
Type 


1(2) 


Sub protocol type, e.g., AMEX-IS08583, 
MOSET, etc., 


Auth Only DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Auth Capture DC 
Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Adjust DC Flag 


Bit(l bit) 


1 - REQUIRED, 0 = NOT REQUIRED 


Refund DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Cash Advance DC 
Flag 


Bit(l bit) 


1 - REQUIRED, 0 = NOT REQUIRED 


Cash Back DC Flag 


Bit(l bit) 


1 - REQUIRED, 0 = NOT REQUIRED 


Off-line Auth DC 
Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Void DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Pre-Auth DC Flag 


Bit(l bit) 


1 = REQUIRED, 0 = NOT REQUIRED 


Pre-Auth Complete 
DC Flag 


Bit(l bit) 


1 » REQUIRED, 0 » NOT REQUIRED 



this 



5 

Card Definition Table (CDT) 

This table contains information which are specific to the card issuer. 
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Field 


Attributes/ 
Bytes 


Field Description/ Comments 


Host Index 


1(2) 


Index into the HDT or the acquirer which maps 
to this card issuer. 


PAN Low Range 


N(19) 


Low end of the PAN range . 


PAN High Range 


N(19) 


High end of the PAN range. 


Minimum PAN 
digits 


1(2) 


The minimum number of digits in the PAN for 
this acquirer. 


Maximum PAN 
digits 


1(2) 


The maximum number of digits in the PAN for 
this acquirer. 


Card Label 


ANS(20) 


Card Issuer Name for identification, e.g., VISA. 


The following fields specify whether a particular transaction is allowed for a card range. 


Field 


Attributes/ 
Bytes 


Field Description/ Comments 


Auth Only Allowed 


Bit(l bit) 


1 = ALLOWED, 0 « NOT ALLOWED 


Auth Capture 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Adjust Allowed 


Bit(l bit) 


1 - ALLOWED, 0 = NOT ALLOWED 


Refund Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Cash Advance 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 - NOT ALLOWED 


Cash Back Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Off-line Auth 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Void Allowed 


Bit(l bit) 


1 = ALLOWED, 0 « NOT ALLOWED 


Pre-Auth Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 


Pre-Auth Complete 
Allowed 


Bit(l bit) 


1 = ALLOWED, 0 = NOT ALLOWED 
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Communications Parameter Table (CPT) 

This table contains communications parameters information specific to an acquirer, 
and this table have a one-to-one mapping between them. 



r teio 


Attributes/ 
Bytes 


Field Description/Comments 


Primary Address 


AN(IOO) 


Primary Host Address (Telephone number, IP 
address, etc.) 


Secondary Address 


AN(100) 


Secondary Host Address to be used if the 
Primary Address is busy or not available. 


Tertiary Address 


AN(IOO) 


Tertiary Host Address. 


Response Time-out 


1(2) 


Time-out value (in seconds) before which the 
vPOS should receive a response from the host. 


This table contains in 


Terminal Configuration Table (TCT) 

formation specific to a particular vPOS terminal. 


Field 


Attributes/ 
Bytes 


Field Description/Comments 


Merchant Name 


ANS(IOO) 


Name of the merchant having the vPOS 
terminal. 


vPOS Lock Flag 


Bit (1 bit) 


1 = vPOS Locked, 0 - vPOS Unlocked 



Payment Instruments 

As discussed above, the vPOS terminal supports different Payment Instruments and each of the 
Payment Functions described above can be initiated by these different Payment Instruments. 
The consumer making a purchase from a merchant provides a choice of payment methods 
depending upon their personal preference. The Payment instrument Class Hierarchy which is 
used by the different vPOS terminal Payment Functions is described below. 



Message Sequence Diagram 
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Figure 17 shows a typical message flow between the consumer, merchant, vPOS terminal and 
the Gateway. This section describes the different classes listed in the previous section, their 
data and members, and defines the type of the transaction that is to be performed. Processing 
commences at 1700 when a merchant server receives a sales order and passes it via the vPOS 
Graphical User lnterfece (GUI) 1710 to an authorizer 1720 for approval and subsequent 
protocol processing 1730 and ultimately transmission via the gateway 1740 to the network. 



Class Name : 

CVPCLTransaction 

Data : 

Transaction Type (int| 

Transaction Date and Time (CPCLDateTime) 
Card Definition Table (CVPCL.CDT) 
Host Definition Table (CVPCLJHDT) 
Communications Parameters Table (CVPCL.CPT) 
Terminal Configuration Parameters (CVPCLJTCT) 
Batch Record (CVPCLBatch) 
Accumulator Record (CVPCLAccum) 
Member Functions : 
CVPCLTransactionO; 
EStatus GetTransType(); 
EStatus GetTransDateTime(CPCLDateTime&); 
EStatus SetTransType(const int); 
virtual EStatus InitializeTrans(TvPOSParamsBlk *) = 0; 
virtual EStatus ExecuteTrans(TvPOSResultsBlk *) - 0; 
virtual EStatus ShutDown() » 0; 

Host Transaction Class Definitions 

This section contains all the host transaction class definitions. 

Host Transaction Class (CVPCLHostTrans) 
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This is an abstract base class derived from the CVPCLTransaction class and is used for deriving 
transaction classes which need to communicate with the host either immediately or at a later 
stage. 

Class Name : 

CVPCLHostTraus 
Data : 



Member Functions : 

CVPCLHostTransQ; 



Financial Transaction Class (CVPCLFinancialTrans) 

This is an abstract base class derived from the CVPCLHostTrans. This class is used to derive 
transaction classes which require a payment instrument (e.g., a Credit Card) associated with 
them to perform the transaction. 



Class Name : 

CVPCLFinancialTrans 
Date: 

Transaction Amount (CVPCLAmt) 
Purchase Order Number [char[l]) 
Transaction Number (char[]) 
Authorization identification Number (char[]( 
Retrieval Reference Number (char[J) 
Batch (CVPCLBatch) 
Accumulators (CVPCLAccumulators) 
Member Functions : 

CVPCLFinancialTrans!) ; 
EStatus GetTransAmt(CVPCLAmt&); 

EStatus GetPurchOrderNum(char *); 

EStatus GetTransRefNum(char *); 

EStatus GetRetRefNum(char *); 
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EStatus GetAuthid(char *); 
EStatus GetCurrencyType(EPCLCurrency *); 
EStatus SetPurchOrderNum(const char *); 
EStatus SetTransRefNum(const char *); 
EStatus SetRetRefNum(const char *); 
EStatus SetAuthId(const char *); 
EStatus SetCurrencyType (const char *] 

Financial Credit Card Transaction Class (CVPCLFinCCTrans) 

This is the base abstract class for the financial host transaction which require a Credit Card 
payment instrument. This class is derived from the CVPCLFinanciaJTrans. 

Class Name : 

CVPCLFinCCTrans 
Data : 

Credit Card Payment Instrument (CPCLCreditCard) 

Member Functions : 

CVPCLFinCCTransQ; 

Credit Card Authorization Only Transaction Class (CVPCL_CCAuthOnly) 

This is the class derived from the CVPCLFinCCTrans class and implements the Authorization 
Only Transaction. 

Class Name : 

CVPCL_CCAuthOnly 
Data: 

Member Functions : 

CVPCL_CCAuthOnly(); 
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EStatus InitializeTransfTvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTransf); 
EStatus FormBatchRecQ; 

Credit Card Authorization with Capture Transaction Class (CVPCL_CCAuthCapt) 

This is the class derived from the CVPCLFinCCTrans class and implements the Auth< 
with Data Capture Transaction. 



Class Name : 

CVPCL_CCAuthCapt 

Data : 

Member Functions : 

CVPCL_CCAuthCapt(); 

EStatus InitializeTransfTvPOSParamsBlk *); 

EStatus ExecuteTransfTvPOSResultsBlk *); 

EStatus ShutDownTransf); 

EStatus FormBatchRec(); 

Credit Card Return Transaction Class (CVPCL_CCReturn) 

This is the class derived from the CVPCLFinCCTrans class and implements th< 
Transaction. 



Class Name : 

CVPCL_CCReturn 
Data : 



Member Functions : 

CVPCL_CCReturn(); 

EStatus InitializeTransfTvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTrans(); 
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EStatus ForrnBatchRecO; 

Credit Card Pre-Authorixation Transaction Class |CVPCL_CCPreAuth) 

This is the class derived from the CVPCLFinCCTrans class and implements the Pre- 
Authorization Transaction. 

Class Name : 

CVPCL_CCPreAuth 

Data : 

Member Functions : 

CVPCL_CCPreAuth(); 

EStatus InitializeTransfTvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *) ; 
EStatus ShutDownTrans(); 
EStatus FormBatchRec(); 

Credit Card Off-line Authorization Only Transaction Class (CVPCL.CCOfllineAuth) 

This is the class derived from the CVPCLFinCCTrans class and implements the Offline 
Authorization Class Transaction. 
Class Name : 

CVPCL_CCOfllineAuth 

Data: 

Member Functions : 

CVPCL_CCOffiineAuth(); 

EStatus InitializeTransfTvPOSParamsBlk *); 

EStatus ExecuteTransfTvPOSResuitsBlk *); 

EStatus ShutDownTrans(); 

EStatus FormBatchRecO; 

Credit Card Adjust Transaction Class (CVPCL.CCAdjust) 

This is the class derived from the CVPCLFinCCTrans class and implements the Adjust 
Transaction. 
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Class Name : 

CVPCL.CCAdjust 
Data: 



Member Functions : 

CVPCL_CCAdjust(); 

EStatus lnitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTransQ; 
EStatus FormBatchRecQ; 



Credit Card Void Transaction Class (CVPCL^CCVoid) 

This is the class derived from the CVPCLFinCCTrans class and implements the Void 
Transaction. 

Class Name : 

CVPCL_CCVoid 

Data: 

Member Functions : 

CVPCL_CCVoid(); 

EStatus InitializeTransfTvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTrans(); 
EStatus FormBatchRecfl; 

Credit Card Forced Post Transaction Class |CVPCL_CCForcedPost> 

This is the class derived from the CVPCLFinCCTrans class and implements the Forced Post 
Transaction. 
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Class Name : 

CVPCL_CCForcedPost 
Data : 

Member Functions : 

CVPCL_CCForcedPost(); 

EStatus InitiaiizeTransfTvPOSParamsBIk *); 

EStatus ExecuteTrans(TvPOSResultsBlk *); 

EStatus ShutDownTransQ; 

EStatus FonnBatchRec(); 

Pre-Authorization Complete Transaction Class (CVPCL_CCPreAuthComp) 

This is the class derived from the CVPCLFinCCTrans class and implements the Pre- 
Authorization Completion Transaction. 

Class Name : 

CVPCL.CCPreAuthComp 
Data : 

Member Functions : 

CVPCL_CCPreAuthComp() ; 

EStatus InitiaiizeTransfTvPOSParamsBIk *); 

EStatus ExecuteTrans(TvPOSResultsBlk *); 

EStatus ShutDownTransQ; 

EStatus FormBatchRecO; 

Credit Card Balance Inquiry Class |CVFCL_CCBaUnceInq) 

This class is derived from the CVPCLFinCCTrans class and is used to perform the Merchant 
Balance Inquiry function. 

Class Name : 

CVPCLJXBalancelnq 
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Data : 

Member Functions : 

CVPCL_CCBalanceInq() ; 
5 EStatus lnitializeTrans(TvPOSParamsBlk *); 

EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

Administrative Host Transaction Class (CVPCLAdminHostTrans) 

1 0 This is an abstract base class derived from the CVPCLHostTrans class and is used to derive th< 
administrative host transaction classes. 

Class Name : 

CVPCLAdminHostTrans 

15 Data: 

Member Functions : 

CVPCLAdminHostTrans(); 
int GetHostindexf); 
20 EStatus SetHostlndex (const int); 

Reconcile Transaction Class (CVPCLReconcilc) 

This is the class derived from the CVPCLAdminHostTrans class and implements the Reconcile 
or Close functionality. 
25 Class Name : 

CVPCLReconcilc 
Data : 

Member Functions : 

30 CVPCLReconcile(); 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
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EStatus ShutDownTransO; 



Host Log-on Transaction Class (CVPCLHostLogon) 

This is the class derived from the CVPCLAdminHostTrans class and implements the Host Log- 
on Transaction. 



Class Name : 

CVPCLHostLogon 
Data : 

Member Functions : 

CVPCLHostLogonO; 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTransO; 

Parameters Download Transaction Class (CVPCLParamsDwnld) 

This is the class derived from the CVPCLAdminHostTrans class and implements t 
Download (vPOS configuration information from the host) functionality. 

Class Name : 

CVPCLParamsDwnld 

Data : 



Member Functions : 

CVPCLParamsDwnld(); 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTransO; 

Test Transaction Claaa (CVPCLTestHost) 

This is the class derived from the CVPCLAdminHostTrans class and implements 
functionality which is used to test the host and the link. 
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Class Name : 

CVPCLTestHost 
Data : 

Member Functions : 

CVPCLTestHostf); 

EStatus InitiaiizeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTransf); 

Local Transaction Class Definitions (CVPCLLocalTrans) 

This is the abstract base class for all the transactions that are performed locally to 

Class Name : 

CVPCLLocalTrans 

Data : 

Record Number (int( 
Host Index (int) 
Member Functions : 

CVPCLocalTransQ; 
int GetRecNum(); 
int GetHostIndex() 
EStatus SetRecNum(const int); 
EStatus SetHostIndex(const int); 



Virtual POS Lock/ Stop Class (CVPCLvPOSLock) 

This class implements the vPOS Lock or the Stop Local functionality. Under the locked 
the vPOS does not accept any transaction requests. The class is derived from the 
CVPCLLocalTrans base class. 
Class Name : 
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CVPCLvPOSLock 

Data: 

Member Functions : 

CVPCLvPOSLock(); 

EStatus InitiaiizeTransfTvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResuitsBlk *); 
EStatus ShutDownTransQ; 

Virtual POS UnLock/ Start Class (CVPCLvPOSUnlock) 

This class implements the vPOS UnLock or the Start Local functionality. The class is derived 
from the CVPCLLocalTrans base class. 

Class Name : 

CVPCLvPOSUnLock 

Data : 

Member Functions : 

CVPCLvPOSUnlockf); 

EStatus InitiaiizeTransfTvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

Transaction Data Administration Class (CVPCLTransDataAdmin) 

This is an abstract base class used to derive the classes which are required to review/manage 
the transaction data which includes the batch data and the accumulator data. The class is 
derived from the CVPCLLocalTrans base class. 

Class Name : 

CVPCLTransDataAdmin 

Data : 

Member Functions : 

CVPCLTransDataAdmin(); 
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Batch Review Class (CVPCLBatchReview) 

This class is derived from the CVPCLTransDataAdmin base class and implements the 
review functionality 
Class Name : 

CVPCLBatchReview 

Data : 



Member Functions : 

CVPCLBatchReview!) ; 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTransQ; 



Clear Batch Class <CVPCLClearBatch) 

This class is derived from the CVPCLTransDataAdmin base class and implements the 
batch functionality, which is used to clear the batch in the event of doing a manual 
reconciliation between the vPOS and the acquirer.. 



Class Name : 

CVPCLClearBatch 

Data : 

Member Functions : 

CVPCLClearBatchO; 

EStatus InitializeTransfTvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTransQ; 



Accumulators Review Class (CVPCLAccumReview) 

This class is derived from the CVPCLTransDataAdmin base class and implements 
Accumulators Review functionality. 
Class Name : 
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CVPCLAccumReview 

Data : 

Member Functions : 

CVPCLAccumReview(); 
EStatus InitializeTrans(TvPOSParamsB]k *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

Clear Accumulators Class (CVPCLClcarAccum) 

This class is derived from the CVPCLTransDataAdmin base class and implements the 
Accumulators Clear functionality. 

Class Name : 

CVPCLClearAccum 

Data : 

Member Functions : 

CVPCLCiearAccum(); 

EStatus InitializeTransflVPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

vPOS Configuration Data Administration Class (CVPCLConfigDataAdmin) 

This is an abstract base class and is used to derive classes which implement the functionality 
for managing the vPOS configuration data. The class is derived from the CVPCLLocalTrans 
base class. 

Class Name : 

CVPCLConfigDataAdmin 

Data : 

Member Functions : 

Acquirer Data or the Host Definition Table Review Class (CVPCL.HDTReview) 

This class is derived from the CVPCLConfigDataAdmin class and implements the Host 
Definition Table Review functionality. 
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Class Name : 

CVPCL_HDTReview 

Data : 

Member Functions : 

CVPCL_HDTReview(); 

EStatus InitializeTrans(TvPOSParamsBlk # ); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

Issuer Data or the Card Definition Table Review Class (CVPCL_CDTReview) 

This class is derived from the CVPCLConfigDataAdmin class and implements the Card 
Definition Table Review functionality. 
Class Name : 

CVPCL.CDTReview 

Data : 

Member Functions : 

CVPCL_CDTReview(); 

EStatus InitializeTransfTvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBik *); 
EStatus ShutDownTrans(); 

Communication Parameters Table Review Class (CVPCL CPTReview) 

This class is derived from the CVPCLConfigDataAdmin class and implements the 
Communications Parameters Table Review functionality. 

Class Name : 

CVPCL_CPTReview 

Data : 



Member Functions : 
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CVPCL_CPTReview(); 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTrans(TvPOSResuitsBlk *); 
EStatus ShutDownTransQ; 

Terminal Configuration Tabic Review Class |CVPCL_TCTReview) 

This class is derived from the CVPCLConfigDataAdmin class and implements the Terminal 
Configuration Table Review functionality. 

Class Name : 

CVPCLJTCTReview 

Data : 

Member Functions : 

CVPCLJTCTReview(); 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

Acquirer Data or the Host Definition Table Update Class (CVPCI^HDTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements the Host 
Definition Table Update functionality. 
Class Name : 

CVPCL_HDTUpdate 

Data : 

Member Functions : 

CVPCL_HDTUpdate(); 

EStatus InitializeTrans(TvPOSParamsBlk *); 
EStatus ExecuteTransfTvPOSResultsBlk *); 
EStatus ShutDownTrans(); 
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Issuer Data or the Card Definition Table Update Class (CVPCL.CDTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements the Card 
Definition Table Update functionality. 
Class Name : 

CVPCL_CDTUpdate 

Data : 

Member Functions : 

CVPCL_CDTUpdate(); 

EStatus InitializeTransfTvPOSParamsBIk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTransQ; 

Communications Parameters Table Update Class (CVPCL_CPTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements the 
Communications Parameters Table Update functionality. 



Class Name : 

CVPCL.CPTUpdate 

Data : 



Member Functions : 

CVPCL_CPTUpdate(); 

EStatus InitializeTransfTvPOSParamsBIk *); 
EStatus ExecuteTrans(TvPOSResultsBlk *); 
EStatus ShutDownTrans(); 

Terminal Configuration Table Update Class (CVPCL_TCTUpdate) 

This class is derived from the CVPCLConfigDataAdmin class and implements the ' 
Configuration Table Update functionality. 



Class Name : 

CVPCL.TCTUpdate 
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Data : 

Member Functions : 

CVPCL_TCTUpdate(); 

EStatus InitializeTransfTvPOSParamsBlk *); 
5 EStatus ExecuteTrans(TvPOSResultsBlk *); 

EStatus ShutDownTransO; 

Batch Class (CVPCLBatch) 

This class defines the batch record and the operations which are performed on the batch. 

10 

Class Name : 

CVPCLBatch 

Data: 

Batch Record Structure (TvPOSBatchRec) 
15 / / Definition of the TvPOSBatchRec is as below, 

typedef struct _vPOSBatchRec 



{ 





char 


szTransAmtf]; 






char 


szTransDate(); 




20 


char 


szTransTime[); 






char 


szRetrievalRefNum[]; 


// Trans. Ref. No. sent by the host 




char 


szAuthId[]; 


/ / Approval Code sent by the host 




char 


szOrigAmt(]; 


/ / Original amount for - Adjust 




char 


szPurchOrderNum[]; 




25 


char 


szBatchNumJ]; 





EPCLTransType TransType; 
EPCLPmtinst Pmtlnst; 
EPCLCurrency CurrencyType; 
EPCLDecimals NumDecDigits; 
30 unsigned int nTransRefNum; / / Running Ref. Number gen. by the 

//vPOS for every approved txn. 
unsigned long InSTAN; // Sys. Trace Number incr. by vPOS 
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/ / for every trans, that is trans, to host 

TPmtlnstData PaylnstData; 
( TvPOSBatchRec; 
Member Functions : 

5 CVPCLBatchQ; 

EStatus SetTransType(const EPCLTransType); 

EStatus SetRetRefNumfconst char *); 

EStatus SetAuthldfconst char *); 

EStatus SetPurchOrderNum(const char *); 
10 EStatus SetTransRefNum(const long); 

EStatus SetTransAmt (const char *); 

EStatus SetBatchNum(const char *); 

EStatus SetSTAN(const long); 

EStatus SetDateMMDDYYYYfconst char *); 
1 5 EStatus SetTimeHHMMSSfconst char *); 

EStatus SetPmtInst(const EPCLPmtlnst); 

EStatus SetCCAcctNum(const char *); 

EStatus SetCCExpDatefconst char *); 

EStatus SetOrigAmtfconst char *); 
20 EStatus GetBatchRecfTvPOSBatchRec *); 

EStatus InitBatch(); 

EStatus OpcnBatch(const char \ FILE **, const char *); 
EStatus CloseBatch(FILE *); 

EStatus AddBatchRec (); // Adds a record to the batch 

25 EStatus GetBatchRec (const long); / / Gets a record from the batch 

EStatus UpdateBatchRec (const long); // Update batch record with NR 
EStatus DeleteBatchRec (const long); / / Deletes the batch record 

Accumulator Class (CVPCLAccnm) 

30 This class defines the Accumulator record and the operations on the accumulators. 
Class Name : 

CVPCLAccum 
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Data : 

Credit Amount (char szCreditAmt[AMT_SZ + 1]) 
Credit Count (int nCreditCnt) 
Debit Amount (char szDebitAmt|AMTJSZ +1) 
Debit Count (int nDebitCnt) 
Member Functions : 

int OpenAccum(int fHandle); 

int GetAccum (int nAccumType, int *pnAccumCnt, char *pszAccumAmt); 
int CloseAccum(int fHandle); 
int CIeanAccum(); 

Host Definition Table Class (CVPCL.HDT) 

This class defines the Host Definition Table record and the operations on the table. 
Class Name : 

CVPCLJBDT 

Data : 

Host Definition Table Record Structure (TvPOSHDTRec ) 
The TvPOSHDTRec structure contains the following fields, 
typedef struct jvPOSHDTRec 

( 

char szTermld[l; 

char szMerchId(]; 

char szBatchNum(]; 

char szTPDU[); 

char szNIl(]; 

char szHostNamed; 

EPCLHostProtType HostProtType; 

EPCLHostProtSubType HostProtSubType; 

// Data Capture Required Flags 

vPOSBool lAuthOnlyDC; 

vPOSBool iAuthCaptDC; 

vPOSBool fForcedPostDC; 
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vPOSBool fAdjustDC; 
vPOSBool fReturnDC; 
vPOSBool fOfflineAuthDC; 
vPOSBool fVoidDC; 
5 vPOSBool fPreAuthDC; 

vPOSBool fPreAuthCompDC; 

unsigned int nNumAdv; // Max. No. of piggy-back trans, allowed 
unsigned int nTransRefNum; 

unsigned long InSTAN; / / Systems Trace Number 
10 ) TvPOSHDTRec; 

Member Functions : 

CVPCL_HDT(); 

EStatus CleanHDT(); 
1 5 EStatus LoadHDTRecfconst int); 

EStatus SaveHDTRecfconst int); 

EStatus GetNumRecsfint *); 

EStatus GetHDTRec(TvPOSHDTRec *); 

EStatus GetTermldfchar *); 
20 EStatus GetMerchId(char *); 

EStatus GetBatchNum(char *) ; 

EStatus GetTransRefNum(unsigned int *); 

EStatus GetTPDU(char *); 

EStatus GetNIIfchar *); 
25 EStatus GetHostName(char *) ; 

EStatus GetHostProtType(EPCLHostProtType *); 

EStatus GetHostProtSubType(EPCLHostProtSubType *); 

EStatus GetNumAdv(unsigned int *); 

EStatus GetSTAN(unsigned long *); 
30 EStatus GetAuthOnlyDC(vPOSBool *); 

EStatus GetAuthCaptDC(vPOSBooi *); 

EStatus GetAdjustDQvPOSBool *); 
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EStatus GetReturnDC(vPOSBool *); 

EStatus GetForcedPostDC{vPOSBool *); 

EStatus GetOfflineAuthDC(vPOSBool *); 

EStatus GetVoidDC(vPOSBool *); 

EStatus GetPreAuthDC(vPOSBool *); 

EStatus GetPreAuthCompDC(vPOSBool *); 

EStatus SetHDTRec(TvPOSH DTRec *); 

EStatus SetTermId(const char *); 

EStatus SetMerchId(const char *); 

EStatus SetBatchNum(const char *); 

EStatus SetTransRefNum(const unsigned int); 

EStatus SetTPDUfconst char *); 

EStatus SetSTAN(const unsigned long); 

EStatus SetNIl(const char *); 

EStatus SetHostName(const char *); 

EStatus SetHostProtType(const EPCLHostProtType); 

EStatus SetHostProtSubType(const EPCLHostProtSubType); 

EStatus SetNumAdv(const int); 

EStatus SetAuthOnlyDC(const vPOSBool); 

EStatus SetAuthCaptDC(const vPOSBool); 

EStatus SetAdjustDC(const vPOSBool); 

EStatus SetReturnDC(const vPOSBool); 

EStatus SetForcedPostDC(const vPOSBool); 

EStatus SetOfflineAuthDC(const vPOSBool); 

EStatus SetVoidDC(const vPOSBool); 

EStatus SetPreAuthDC(const vPOSBool); 

EStatus SetPreAuthCompDC(const vPOSBool); 

Card Definition Table Class (CVPCL^CDT) 

This class defines the Card Definition Table record and the operations on 
Class Name : 

CVPCL_CDT 
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Data : 

Card Definition Table Record Structure (TvPOSCDTRec ) 
The TvPOSCDTRec structure contains the following fields, 
typedef struct .vPOSCDTRec 
5 I 

char szPANLo[); 

char szPANHi(|; 

char szCardLabel(l; 

int nHostlndex; 
10 int nMinPANDigit; 

int nMaxPANDigit; 

/ / Transaction Allowed Flags 

vPOSBool fAuth Only All wd; 

vPOSBool fAuthCaptAllwd; 
\ 5 vPOSBool fForcedPostAllwd; 

vPOSBool fAdjustAllwd; 

vPOSBool fReturnAllwd; 

vPOSBool fOfllineAuthAllwd; 

vPOSBool fVoidAllwd; 
20 vPOSBool fPreAuthAllwd; 

vPOSBool fPreAuthCompAllwd; 
j TvPOSCDTRec; 



Member Functions : 

25 CVPCL.CDT0; 

EStatus CleanCDT(); 

EStatus LoadCDTRec(const int); 

EStatus SaveCDTRecfconst int); 

EStatus GetNumRecs(int *); 
30 EStatus GetCDTRec(TvPOSCDTRec *); 

EStatus GetPANLo(char *); 

EStatus GetPANHi(char *); 
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EStatus GetCardLabel(char *); 
EStatus GetCDTHostIndex(int *); 
EStatus GetMinPANDigit(int *); 
EStatus GetMaxPANDigit(int *); 
EStatus GetAuthOnlyAllwd(vPOSBool *); 
EStatus GetAuthCaptA11wd(vPOSBool *); 
EStatus GetAdjustAllwd(vPOSBool *); 
EStatus GetReturnAllwdfvPOSBool *); 
EStatus GetOfflineAuthAllwd(vPOSBool *); 
EStatus GetVoidAllwd(vPOSBool *); 
EStatus GetPreAuthAllwd(vPOSBool *); 
EStatus GetPreAuthCompAllwd(vPOSBool *); 
EStatus GetForcedPostAllwd(vPOSBool *); 
EStatus SetCDTRec(TvPOSCDTRec *); 
EStatus SetHostlndexfconst int); 
EStatus SetMinPANDigit(const int); 
EStatus SetMaxPANDigit(const int); 
EStatus SetPANLo(const char *); 
EStatus SetPANHi(const char *); 
EStatus SetCardLabel(const char *); 
EStatus SetAuthOnlyAllwd(const vPOSBool); 
EStatus SetAuthCaptAllwd(const vPOSBool); 
EStatus SetAdjustAllwd(const vPOSBool); 
EStatus SetReturnAllwd(const vPOSBool); 
EStatus SetForcedPostAllwd(const vPOSBool); 
EStatus SetOfflineAuthAllwd(const vPOSBool); 
EStatus SetVoidAllwd(const vPOSBool); 
EStatus SetPreAuthAllwdfconst vPOSBool); 
EStatus SetPreAuthCompAllwd(const vPOSBool); 

Communications Parameters Table Class (CVPCL_CPT) 

This class defines the communicauons parameters table and the operations on the table. 
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Class Name : 

CVPCL.CPT 

Data: 

Communications Parameters Table Record Structure (TvPOSCPTRec ) 
The TvPOSCPTRec structure contains the following fields, 
typedef struct j/POSCPTRec 

1 

char szAcqPriAddressj]; 
char szAcqSecAddress[); 
char szAcqTerAddress[] ; 

int nRespTimeOut; 
j TvPOSCPTRec; 

Member Functions : 

CVPCL_CPT(); 
EStatus CleanCPT(); 
EStatus LoadCPTRec(const int); 
EStatus SaveCPTRecfconst int); 
EStatus GetNumRecs(int *); 
EStatus GetCPTRec(TvPOSCPTRec *); 
EStatus GetAcqPriAddress(char *); 
EStatu s GetAcqSecAddress(char *); 
EStatus GetAcqTerAddress(char *); 
EStatus GetRespTimeOut(int *); 
EStatus SetCPTRecfTvPOSCPTRec *); 
EStatus SetAcqPriAddress(const char *); 
EStatus SetAcqSecAddress(const char *); 
EStatus SetAcqTerAddress(const char *); 
EStatus SetRespTimeOut(const int); 
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Terminal Configuration Tabic Class (CVPCL_TCT) 

This class defines the vPOS terminal configuration parameters table and the operations on 
table. 

Class Name : 

CVPCL_TCT 

Data : 

Terminal Configuration Table Record Structure (TvPOSTCTRec ) 

The TvPOSTCTRec structure contains the following fields, 
typedef struct _vPOSTCTRec 
{ 

char szMerchName(]; 

vPOSBool fvPOSLock; / / vPOS Lock/ Unlock Toggle Flag 

} TvPOSTCTRec; 

Member Functions : 

CVPCL_TCT(); 

EStatus LoadTCTRec(); 

EStatus SaveTCTRecQ; 

EStatus CleanTCT(); 

EStatus GetTCTRec(TvPOSTCTRec *); 

EStatus GetMerchName(char *); 

EStatus GetvPOSLock(vPOSBool *); 

EStatus SetMerchName(const char *); 

EStatus SetvPOSLock(const vPOSBool); 

Amount Class (CVPCLAmount> 

This class defines the amount data items and the operations on them. 

Class Name : 

CVPCLAmount 

Data: 
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Amount (char|)) 
Currency Type (EPCLCurrency) 
Member Functions : 

CVPCLAmountf); 
5 EStatus lnitialize(const CPCLAmount&); 

EStatus lnitialize(const char *); 
EStatus lnitialize(const long); 
void operator = (const char *); 
void operator = (const Jong); 
1 0 EStatus GetAmount(char *); 

operator const char * () const; 
operator const long (); 



Payment Instruments Class (CPCLPmtlnst) 

15 This section defines the Payment Instrument Class hierarchy. Figure 16 illustrates a 
transaction class hierarchy in accordance with a preferred embodiment. 



Class Name : 

CPCLPmtlnst 

20 Data : 

Payment Instrument Type (EPCLPmtlnst) 
Member Functions : 

CPCLPmtlnst(); 

EStatus GetPmtInstType(EPCLPmtInst *); 



25 



Bank Cards Class (CPCLBankCard) 

This class is derived from the CPCLPmtlnst class and implements the bank cards class. 



Class Name : 
30 CPCLBankCard 
Data : 

Account Number (char[ ]) 
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Expiration Date (CPCLDateTime) 
Index into the CDT table (int) 
Member Functions : 

CPCLBankCard(); 

EStatus Initialize!) ; 
EStatus SetAcctNum(const char *); 
EStatus SetExpDate(const char *); 
EStatus GetAcctNum(char *); 
EStatus GetExpDate(char *); 
EStatus ValidateCard(); 
int GetCDTIndexf); 
vPOSBool DoLuhnCheck(); 
vPOSBool DoCardRangingO; 
EStatus DoValidateExpDate(); 

Credit Cards Class (CPCLCreditCard) 

This class is derived from the CPCLBankCard class and has the same data and the methods as 
the CPCLBankCard class. 
Class Name : 

CPCLCreditCaxd 

Data: 

Member Functions : 

CPCLCreditCard(); 

Debit Cards Class (CPCLDebitCard) 

This class is derived from the CVPCLBankCard class and implements the debit card class. 

Class Name : 

CPCLDebitCard 

Data : 



WO 98/05011 



-95- 



PCTYUS97/13673 



Card Holder Encrypted PIN (char[ ]) 
Member Functions : 

CPCLDebitCard(); 
EStatus GetEncryptedPIN(char *); 
5 EStatus SetEncryptedPIN(char *); 



vPOS Class Library Interface and API Definition 

This section explains the classes which provide the interface to the vPOS class library. 

10 

Data Structures required for the vPOS Interface Class 

Transaction Parameters Structure (TvPOSParamsBlk) - This structure is a subset of all the 
transaction parameters required for the different transactions. 

1 5 typedef struct _vPOSParamsBlk 

{ 

char szTransAmt[|; / / Without decimal point. 

/ / Left most two digits implied to be decimal digits 

char szPurchOrderNum|); 
20 char szRetRefNum(j; 

char szBatchNum[]; 

char szNewBatchNum[]; 

char szOrigAmt|]; 

char szCPSData[] ; 

25 char szAuthld(l; / / Auth Id for offline auth-only transaction 

int Hostlndex; 

unsigned int nTransRefNum; 
vPOSBool fvPOSLock; 
ECPSDataType eCPSType ; 
30 EPCLTransType TransType; 

EStatus TransResult; 
EPCLPmtlnst Pmtinst; 
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EPCLCurrency CurrencyType; 
EPCLDecimals Num Dec Digits; 
EVPCLAccumType AccumType; 
TPmtlnstData PaylnstData; 
5 union _vPOSConfigData 

{ 

TvPOSHDTRec srHDTRec; 
TvPOSCDTRec srCDTRec; 
TvPOSCPTRec srCPTRec; 
10 TvPOSTCTRec srTCTRec; 

} vPOSConfigData; 

void *Context; / / Context from the calling interface 

EStatus (*vPOSCallBack)(TvPOSResultsBlk *, void *); 

15 } TvPOSParamsBlk; 

Transaction Results Structure (TvPOSResultsBlk) - This structure contains all the fields 
returned from the host and other fields which are required for doing terminal data capture. 

20 typedef struct _vPOSResultsBlk 

I 

char szNewBatchNum[); 

int nHostlndex; 

EStatus TransResult; 
25 TvPOSBatchRec srBatchRec; 

TvPOSAccumRec srAccumRec; 

char szCardLabel(]; 

TvPOSHDTRec srHDTRec; 

TvPOSCDTRec srCDTRec; 
30 TvPOSCPTRec srCPTRec; 

TvPOSTCTRec srTCTRec; 
| TvPOSResultsBlk; 
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The various status codes for the enumeration EStatus are detailed below. 

vPOS Interface Class (CvPOSInterface) 

5 This class provides the interface to the vPOS Transaction Class Library. 
Class Name : 

CvPOSInterface 

Data : 

Member Functions : 

10 CvPOSlnterfaceQ; 

/ / Creates the Transaction Object, takes care 
//of other initialization and executes the transaction. 
CVPCLTransaction *pclTransFactory(TvPOSParamsBlk *); 
EStatus DestroyTrans(CVPCLTransaction *); 

15 

vPOS API Definition 

This section explains in the vPOS API which are required for interfacing with the vPOS Class 
Library. All the different vPOS transactions can be initiated using the API defined in this 
section. 

20 

vPOSInitialixe - Initialize vPOS 

This API is used to start and initialize the vPOS. The API definition is disclosed below. 

API Definition : 

25 vPOSBool vPOSInitialize(void); 

Parameters : 
None 
Returns : 

TRUE or FALSE indicating whether the function call was a success. 

30 

vPOSExecute - Execute a vPOS Transaction 

This API is used to execute a particular vPOS transaction. 
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API Definition : 

vPOSBool vPOSExecute(TvPOSParamsBlk \ TvPOSResultsBlk *) 
Parameters : 

Pointer to the Parameters Structure (TvPOSParamsBIk) 
Pointer to the Results Structure (TvPOSResultsBlk) 
Returns : 

TRUE or FALSE indicating whether the function call was a success. 



This is used to shutdown the vPOS. 
API Definition : 

vPOSBool vPOSShutDown(void) 
Parameters : 

None 
Returns : 

TRUE or FALSE indicating whether the function call was a success. 



This section details the different status codes (listed under the enumeration EStatus) which the 
vPOS returns for the different operations performed, 
enum EStatus 



vPOSShutDown - Shutdown the vPOS 



vPOS Status Codes 



eSuccess s 0, 



eFailure, 
evPOSLocked, 



ePmtinstNotSupported, 

eTransNotSupported, 

eTranslnitErr, 



eAdjustNotAllwd, 

eVoidNotAllwd, 

eForcedPostNotAllwd, 



/ / Function call or operation successful 
/ / General failure 

/ / vPOS locked, transaction not allowed 

/ / Transaction related error codes 

/ / Payment Instrument not supported 

/ / Transacuon type not supported 

/ / Transaction Initialization Failed 

/ / Adjust not allowed on this transacuon 

/ / Void not allowed on this transaction 

/ / Forced Post not allowed on this transaction 
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ePreAuthCompNotAllwd, 


// Pre-Auth. not allowed on this transaction 


eAmtErr, 


/ / Error in the amount passed 


eHDTLoadErr, 


/ / Error during loading the HDT table 


eCDTLoadErr, 


/ / Error during loading the CDT table 


eCPTLoadErr, 


/ / Error during loading the CPT table 


eTCTLoadErr, 


// Error during loading the TCT table 


eHDTWriteErr, 


// Error during writing to the HDT table 


eCDTWriteErr, 


/ / Error during writing to the CDT table 


eCPTWriteErr, 


/ / Error during writing to the CPT table 


eTCTWriteErr, 


// Error during writing to the TCT table 


eTCTFieldErr, 


/ / Error handling a TCT table field 


eLuhnErr, 


// Luhn check failed on the account 


eRangingErr, 


/ / Card range not found 


ePANLenErr, 


/ / PAN length error 


eExpiredCard, 


/ / Card expired 


elnvalidMonth, 


/ / Invalid month in the expiration date 


eFiieOpenErr, 


/ / General file open error 


eFileCloseErr, 


// General file close error 



20 vPOS Terminal Architecture 

Figure 25 is a block diagram of the vPOS Terminal Architecture in accordance with a preferred 
embodiment. The Internet 2500 provides the communication processing necessary to enable 
the vPOS Teminal architecture. The terminal interface CGI 2520 communicates via the 
Internet to provide information to the vPOS OLE Server 2550 which formats information in 
25 accordance with the vPOS API DLL 2560 which uses the protocol class DLL 2570 to flesh out 
the message for delivery to the Gateway Server 2580. The collection of the vPOS OLE Server 
2550, vPOS API DLL 2560 and the Protocol Class DLL 2570 make up the vPOS Software 
Development ToolKit (SDK) which are used to enable vPOS applications for interfacing with an 
Operator 2540. 



vPOS/ GATEWAY Architecture 

The architecture of the Virtual Point of Sale (vPOS) and Virtual Gateway (GATEWAY) 
architecture maintains SET compliance while providing support for additional message types 
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that are not enabled in SET. The architecture includes isolation of cryptographic details in a 
single module to facilitate single version government approval while maximizing the flexibility of 
the system for customization and facilitating transfer of updated versions on an acquirer 
specific basis. Figure 18 is a block diagram of the extended SET architecture in accordance 
5 with a preferred embodiment. Processing commences at function block 1800 for a consumer- 
originated transaction via the World Wide Web (WWW) or 1810 for a merchant-originated 
transaction on the Internet. In either case control passes immediately to the WWW server 
1820 for the transaction to be appropriately formatted and the appropriate interface page 
presented, whether the transaction is a store front 1822, shopping cart 1824, pay page 1826, 

10 standard terminal administration 1828-1830 transaction, or an extended terminal transaction 
1834. If processing requires authentication of the transaction, then control passes through 
the Virtual Point of Sale (vPOS) Application Programming Interface (API) library 1840 for SET 
compliant transactions and through the vPOS API extensions library for extensions to the SET 
protocol. Then, at function block 1842, if the transaction is SET compliant, and function block 

15 1864 if the transaction is not SET compliant, a library of protocol stack information is used to 
conform the message before it is transmitted to a Gateway site for ultimate delivery to a bank 
host 1874 for authorization. 

Extended SET messages are processed at the Gateway site on a two track basis with the 
20 division criteria being SET compliance (which will change over time as more functionality is put 
into SET) or SET extensions. Set compliant messages are processed via the protocol statck 
library 1862, while SET extensions are processed via the protocol stack entension library 
1864. Then, at function block 1870 the gateway engine processes SET and Host specific code 
including gateway administration extensions 1872 that bypass the normal processing and flow 
25 directly from the merchant and consumer server 1820 to the gateway administration 
extensions 1872 to the Gateway Engine 1870. 

As described above, there are three channels by which messages are exchanged between vPOS 
1846 and GATEWAY 1856. 

30 



L Standard SET messages 



10 
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The standard SET messages are originated by the merchant software either via a pay page 
1826 directly controlled by the consumer, or via an operator interface consisting of a set of 
HTML pages and associated executables launched by the pages (e.g. pay page 1826 and 
standard terminal administration 1828-1830.) 

Each SET message type (e.g., automation v. capture) transmits a different set of data and 
each requires a different Protocol Data Unit (PDU) to describe its encoding. Examples of how 
Standard SET messages are encoded are given in the SET documentation previously 
incorporated by reference. 



2. Extended SET messages 

The Extended SET messages are utilized as an "escape mechanism" to implement acquirer- 
specific messages such as settlement/ reconciliation, employee logon/logoff, and parameter 
download. The messages are developed as a set of name-value pairs encapsulated in a PKCS-7 
1 5 wrapper and wrapped in Multipurpose Internet Mail Extensions (MIME), described in a book by 
N. Borenstein & N. Freed, "RFC 1521: MIME (Multipurpose Internet Mail Extensions) Part One: 
Mechanismsfor Specifying and Describing the Format of Internet Message Bodies" (Sep. 1993). 
The name-value pairs can have arbitrary (8-bit) data, so arbitrary items can be passed through 
the extended SET channel, including executable programs and Dynamic Load Libraries (DLL)s. 

20 

Figure 18B illustrates a multipart MIME message with one Extended SET message and one 
Standard SET authorizing message- Mime is utilized as an outer wrapper 1890 to allow an 
Extended SET message 1891 to be transmitted as a compon of messages embedded in one 
MIME multipart message. In this manner, a standard SET message can be sent with an 
25 Extended SET message in one vPO S / GATEWAY communication transaction. 



Embedding the Extended SET messages in a PKCS-7 wrapper enables the same message 
authentication to occur as in standard SET messages. Thus, for SET-compliant and non-SI 
compliant messages, the same mechanism may be 
30 used to restrict which entities the vPOS or Gateway will trust in any communications. An 
important concept in Extended SET is that all messages, of any type, are sent in a uniform 
name/ value pair format, thus allowing a single Protocol Data Unit to suffice for any type of 



WO 98/05011 



PCT/US97/13673 



- 102 - 



message sent through the Extended SET channel. Since arbitrary data may be sent this way, a 
mechanism must be provided to preclude the use of the Extended SET channel by parties other 
than approved financial institutions. If this is not ensured, then the NSA and the US 
Department of Commerce will not approve the software for export. 

5 

SET itself to some degree ensures that this Extended SET channel is used only by financial 
institutions. The protocol stack extension library only processes messages that have been 
signed by a financial institution SET certificate that is in turn signed by a payment instrument 
brand certificate (such as Visa or MasterCard). 
1 0 Stronger control over the Extended SET channel can be achieved by further restricting 
processing of messages to those signed (either instead of or in addtion to the financial 
institution SET certificate) by a second certificate belonging to a third-party agency, either 
governmental or private (e.g., VeriFone, as manufacturer of the software). 

1 5 In this way, a particular set of Extended SET messages can be implemented by Bank X, and a 
different set of messages by Bank Y. If a vPOS has an extended terminal transaction interface 
as shown in Figure 18A at block 1834 for Bank X, and has been configured to only accept 
messages from a Gateway with Bank X's certificate, then it will be able to communicate those 
messages to a Gateway that has the certificate for Bank X, and accepts messages of the types 

20 in Bank X's message set. The vPOS will not be able to connect to the Bank Y gateway, or to 
any other system that purports to communicate via Extended SET. This restriction is further 
secured by utilizing a public key certificate that is "hard wired" into vPOS, and which is 
distributed only to gateways that use the Extended SETT mechanism. 

25 Figure 18C is an example flowchart of message processing in accordance with a preferred 

embodiment. Processing commences at function block 1880 when a message is received by an 
HTTPS server or other listener and passed to decision block 1883 to determine if the sending 
vPOS has transmitted an authentic message and if the vPOS is authorized to communicate 
with this gateway. If the message is not authentic, then the message is logged as an error and 

30 the error is handled as shown in function block 1889. If the message is authentic, then the 
message is decrypted at function block 1884 and the PDU parses the message into name / 
value pairs. Then, based on the message type and the extended SET version information, the 
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remaining message is parsed at function block 1885 and the message is checked for 
conformance to the appropriate specification as shown at decision block 1887. If the message 
does not conform, then it is logged and the error handled at function block 1889. If the 
message conforms to the proper specification in decision block 1887 then the message is 
5 translated into the appropriate host format and sent to the host as shown in function block 
1888. Thus, when a gateway receives an incoming message from a vPOS and parses the 
Extended SET portion of the message, a single MIME message can transmit a SET message 
and /or an Extended Set Message. 

1 0 An export license for the encryption can be obtained on a case-by-case basis, and since there 
will be potentially millions of vPOS s, it is desireable to obtain a commodities jurisdiction for the 
vPOS, to enable a single version of the vPOS (rather than one version for each bank) to be 
supported by the vPOS architecture. The architecture described here ensures that the single 
version of vPOS, no matter how it is configured with extended terminal transaction 

1 5 interfaces, cannot be used to communicate any data other than that contained in the extended 
SET messages that have been approved for export by the US government to be used exclusively 
for a specific bank. 



Figure 18D is an example of a simple message between vPOS and Gateway using the Extended 
20 SET channel enabling an employee to sign on, or "logon" to a given terminal in accordance with 
the subject invention. The message must contain the employee's logon ID, a password to be 
verified by the bank host computer, and the date and time as shown at 1894. 

While the contents of the message are shown without encryption in Figure 18D, it should be 
25 noted that the information (including the logon password) are SET encrypted inside the PKCS-7 
wrapper 1894. Certain fields may be designated as mandators' for an Extended SET message, 
to allow the Gateway or vPOS to decide how to handle the message. For the sake of clarity, in 
this message 1894, only two fields, "messagetype" and "ESETversion", are mandatory. These 
fields inform the Gateway that this message is of type "logon," and that the vPOS is using 
30 version "l.OA" of the ESET message formats defined for the Gateway. In this embodiment, the 
length indicator "(5p is used to distinguish the length (in bytes) of the field of type 
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"messagetype" in the message. In this way, there are no special end-of-data characters, and 
therefore arbitrary data need not have any "escaped" characters. 

It should be noted that using escaped characters will work equally well. Total message 
5 integrity is assured by the digital signatures in the PKCS-7 wrapper. This does not, however, 
preclude the use of other checksumming schemes for additional pinpointing of transmission or 
encoding errors. The messagetype and ESETversion name/value pairs facilitate Gateway look 
up of what name/value pairs are expected in the "logon" message. Some name/ value pairs 
may be mandatory, and others may be optional. 

10 . 

Figure 18E is an example of a simple message between vPOS and Gateway using the Extended 
SET channel enabling an employee to sign on, or "logon" to a given terminal in accordance with 
the subject invention. In response to the logon request message from a vPOS, the Gateway 
may respond with a "logon accepted" message 1894, as depicted in Figure 18E, which vPOS, 
15 upon receipt and authentication, then uses to unlock the terminal for that user. 

Figure 49 shows how the vPOS authenticates an incoming response to a request in accordance 
with a preferred embodiment. Processing commences at function block 4930 when a message 
is received by the HTTPS, SET server, or other listener that originated the request to which this 

20 reponse corresponds. The message is passed to decision block 4940 to determine if the sending 
Gateway has transmitted an authentic message and if the gateway is authorized to 
communicate with this vPOS. If the message is not authentic, then the message is logged as 
an error or possible attack and the error is handled as shown in function block 4970. If the 
message is authentic, then the message is decrypted at function block 4950 and the PDU 

25 parses the message into name/value pairs. Then, based on the message type and the extended 
SET version information, the remaining message is parsed at function block 4960 and the 
message is checked for conformance to the appropriate specification as shown at decision block 
4980. If the message does not conform, then it is logged and the error handled at function 
block 4970, If the message conforms to the proper specification in decision block 4980 then 

30 the message is translated into a standardized argument string to be passed to the appropriate 
executable or code entry point in the vPOS, as shown in function block 4990. Thus, when a 
vPOS receives an incoming message from a Gateway and parses the Extended SET portion of 



WO 98/05011 



- 105 - 



PCT/US97/13673 



the message, the message may cause vPOS to execute a program that takes action or queries 
the user to take action. 

3. Gatewav-intitiated messages 
5 Since all SET messages between a merchant and an acquirer are currently merchant-initiated 
(as specified in the SET documentation), there must be a separate mechanism for initiating a 
message from a gateway, for example to request the upload of management information base 
(MIB) data, or to download new parameters. This is accomplished by requiring the gateway to 
send a message to the merchant via a MIME-encapsulated PKCS-? conformant message 
10 containing name-value pairs to the merchant server directly, rather than to the SET module. 
This channel is shown in Figure ISA at block 1860. 

The message is verified for origination from the acquirer, and is utili2ed to either initialize a 
merchant action, such as to update the merchant's administration page (for example by 
1 5 blinking a message saying, "PLEASE RE-INITIALIZE YOUR TERMINAL"), or by initiating a 

request/ response message pair originating from the merchant (for example, "HERE ARE THE 
CONTENTS OF MY MIB"). This is achieved by calling one of the extended terminal transaction 
interfaces (Figure 18A at 1834), which in turn initiates a SET or Extended SET transaction. 

20 Gateway Customization via the Extended SET Channel 

Gateway customization in extended SET is extremely powerful and a novel concept for vPOS 
processing. Each vPOS contains one or more "serial numbers" unique to each copy of the 
software (a serial number may be embedded in the software, or may be a component of a public 
key certificate used in the software). Once a merchant has selected an acquirer and obtained 
25 the appropriate certificates, the vPOS can be customized utilizing the communication link and 
messages containing customization applications. 

A bank distributes vPOS via different sales channels. The first is direct from a bank to an 
existing merchant with whom the bank already has an existing relationship. In this case, a 
30 version of vPOS already customized for a bank is sent to the merchant, either directly by a 

bank, or through a third-party distributor or service bureau. The customizations may involve 
modification or replacement of, for example, a store front 1822, shopping cart 1824, pay page 
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1826, standard terminal administration transaction interface 1828-1830 or an extended 
terminal transaction interface 1834. This is a standard model of distribution of software that 
is customized for small target market segments. 

5 The more interesting case, and the one that concerns the novel use of the Extended SET 
channel, is where the potential merchant acquires, through some non-bank channel, a 
"generic" vPOS which has not yet been customized to interact with a specific bank. This vPOS 
can communicate with a "test gateway", which the merchant may use to experiment with the 
various features of vPOS and to test the integration of the vPOS into a total online storefront. 

10 

In order to actually transact business over the Internet, the merchant must first obtain a 
merchant ID from the merchant bank with which he signs an acquiring agreement. For online 
payment processing, the merchant must also obtain an appropriate set of digital credentials in 
the form of public key certificates and possibly additional passwords, depending on the 
1 5 financial institution. Once these credentials are obtained, the merchant is ready to customize 
the already-obtained vPOS to communicate with a merchant bank's gateway. 

Using the built-in "serial number" certificate and the Test Gateway public key certificate (which 
is "hard- wired" into the vPOS sofware), it is possible to securely download a particular bank's 
20 customization applications to a specific copy of the vPOS software . Once the vPOS is 

appropriately configured, the last stage of customization download is to configure the vPOS so 
that it only responds to a public key certificate of the merchant's acquirer. This process is 
illustrated here in the context of a merchant who obtains a vPOS that talks to the VeriFone test 
gateway, and desires to customize the vPOS to interact with a gateway at a bank. 

25 

The merchant has purchased a vPOS from a non-bank channel. The version communicates 
with the VeriFone Test Gateway. The merchant uses the gateway to learn about using vPOS, 
and to test the integration of his storefront system with his payment system. The merchant 
also obtains certificates for payment processing from a bank, the merchant bank of choise for 
30 the merchant. The merchant is now ready to customize vPOS to talk to the bank gateway. The 
flowchart for the merchant interaction with the Test Gateway is shown in Figure 50. 
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The merchant begins at function block 5000, where the newly -obtained merchant SET 
certificates are installed in the vPOS. The merchant then directs the vPOS to connect to the 
VeriFone Test Gateway, by selecting this option from the vPOS terminal administration home 
page 5005. The choice of this option invokes an extended terminal admin page from the 
5 default set of such pages supplied with the generic version of vPOS. This program guides the 
customization process. 

The merchant, interacting with the extended terminal admin page, navigates to the list of 
gateways which is maintained by the Test Gateway, and selects the bank to connect by 

1 0 selecting from the list of banks, at function block 5015. During this process, the merchant's 
public key certificates are uploaded to the Test Gateway, and checked (at decision block 5025) 
to verify that the certificates have been signed by the bank to customize the bank for the vPOS. 
If the certificates do not match, the merchant is advised of the situation in function block 
5028, and must select a different bank. If the certificates are not valid SET certificates as 

1 5 detected at decision block 5020, the merchant is advised at function block 5028, and the 
session terminates. If the certificates are valid and match the selected bank, customization 
continues at function block 5030. 

The extended terminal administration program in vPOS receives a list of the customizations 
20 from the Test Gateway that must be performed to specialize the vPOS for a specific bank. Some 
of these customizations are mandatory, while others are optional. In function block 5030, the 
vPOS advises the merchant of the customizations, prompting for any choices that must be 
made by the merchant. The merchant's actions at this point drive decision block 5035, in 
which the vPOS either returns itself to the "generic" state and terminates the interaction, or 
25 begins the configuration of the vPOS, depending on the merchant's confirmation of the request 
to begin the configuration. 

If the merchant has authorized the changes, control is passed to function block 5040 where, 
the POS storesthe certificates of any gateways that it will allow future configuration changes to 
30 be initiated from in its database. This may be only a specific bank, such as a bank and the 
Test Gateway, or other combinations. If only a single, non-Test, bank-owned, gateway is 
allowed to download changes, the vPOS is no longer customizable for any other bank. Then, a 
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new copy would be purchased by the merchant to have it customized for another bank. If the 
Test Gateway is still allowed to customize the vPOS, the merchant could switch to another 
merchant bank and have the current vPOS updated to work with the new bank. 

5 In function block 5050, the customization are downloaded to the vPOS. The downloads 

comprise a set of HTML pages and a set of executable programs or scripts that read data from 
the merchant, perform various functions, and present data to the merchant. In general, the 
customizations downloaded may augment or replace in part or in whole any and all of function 
blocks 1822, 1824, 1826, 1828, 1830, or 1834 in Figure 18A. At a minimum, the terminal 
10 "home page" will be replaced so that it points to the new functionality. At this point, the 
customization of the vPOS has been completed, and the merchant may now begin sending 
payment requests to the merchant bank or processor through the vPOS. 

Thread Safe vPOS - TID Allocation 

1 5 Physical terminals process a single transaction at a time since clerks are usually only able to 
process one transaction at a time. Web Servers can process many transactions at a time, so 
payment requests can often occur simultaneously. Thus, the vPOS Software must have 
support for multi-tasking and provide support for multiple threads to be active at the same 
time in the same system as well as the same process. This requirement is relatively straight 

20 forward. However, the authorizing banks require that all transaction requests include a 

Terminal ID (TID), and, for many banks, no single TID may be active in any two transaction 
requests that overlap in time. Thus, the vPOS requires dynamic allocation of TIDs to 
requesting threads. 

25 One way of providing for multiple TID's is to assign a "base" TID, and either an "extension" (a 
set of extra digits appended to the base), or an increment (a number which is added to the base 
to obtain the complete TID). While such a solution can be used for the majority of banks and 
processors, not all banks/ processors can accomodate this solution. One example is First Data 
Corporation. For its ENVOY protocol, the terminal ID must use the Luhn check as recited in an 

30 ISO ransrk, which adds a checksum digit to the the terminal ID to reduce chances of fraud or 
of mistyped information. Thus, to be general enough to handle all bank /processor situations, a 
pool of TID's is used. The TID's stored in the pool need not be a sequential set of numbers; in 
fact they can be alpha /special /numeric combinations, and the TID's need have no relation to 
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one another. In a preferred embodiment, a TID is represented as a token in a pool that can be 
associated with a particular transaction. 

To provide for this requirement, the vPOS provides a TID pool in tabular form in a database 
5 management system (DBMS). This table has two colums: TID NAME & Allocation date/time. 
If the TID date is null, then the TID is not in use and may be assigned. A date/time field is 
utilized to allow TID allocations to expire. TID requests are made utilizing a SQL query on the 
TID Pool to find the first null or expired date/ time, which is replaced with the current 
date/time and the TID name returned. 

10 

REMOTE vPOS 

The unique architecture of the Cardholder 120, Merchant 130 and Gateway 140, as shown in 
Figure IB, provides communication capability between the modules utilizing the Internet to 
support linkages 150 and 170. Since the Internet is so pervasive, and access is available from 

1 5 virtually any computer, utilizing the Internet as the communication backbone for connecting 
the cardholder, merchant and access to the authorizing bank through a gateway allows the 
merchant vPOS software to be remotely located from the merchant's premises. For example, 
the cardholder could pay for goods from any computer system attached to the Internet at any 
location in the world. Similarly, the merchant vPOS system could be located at a central host 

20 site where merchant vPOS systems for various merchants all resided on a single host with their 
separate access points to the Internet. The merchant could utilize any other computer 
attached to the Internet utilizing a SSL or SET protocol to query the remote vPOS system and 
obtain capture information, payment administration information, inventory control 
information, audit information and process customer satisfaction information. Thus, without 

25 having to incur the overhead of maintaining sufficient computer processing power to support 
the vPOS software, a merchant can obtain the information necessary to run a business 
smoothly and avoid hiring IS personnel to maintain the vPOS system. 

vPOS Multi-Merchant Processing 

30 Multiple merchant processing refers to the ability of a plurality of merchants to process their 
individual vPOS transactions securely on a single computer. The architecture relies on each 
payment page obtaining the merchant name in a hidden field on the payment page. The vPOS 
engine receives tfc *. merchant name with a particular transaction and synchronizes the 
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processing utilizing a Set Merchant method. This command causes the vPOS API to look up a 
unique registry tree based on the merchant name. This process causes the vPOS engine to 
engage the appropriate configuration to process the transaction at hand utilizing a Registry 
Tree. A registry tree contains Card Definition Tables (CDT)s, Acquirer Definition Tables (ADT)s, 
Merchant Definition Tables (MDT)s, Protocol Configuration Tables (PCT)s, etc. The CDTs point 
to specific ADTs since each supported card can be supplied by a distinct acquirer. This is one 
form of split connection. Each of the ADTs in turn point to PCTs, and some acquirers can 
support multiple parallel gateways. A merchant's name refers to a unique database in the 
database management system which contains for example, TIDs. 

So, for example, to fully qualify a particular merchant in a multi- merchant system, the 
Acquirer Definition Table is queried to ascertain the particular Gateway (VFITest), then if Bank 
of America requires verification of network communication information, the particular CardDT 
is accessed with for example VISA. The particular merchant will service VISA transactions 
utilizing a particular acquirer. The particular piece of merchandise will also be detailed in a 
data base. Finally, the merchant Configurations wil 1 also be stored in the database to facilitate 
E-mail and name lookup. 

vPOS CLIENT 

The interaction between the vPOS and a client commences when a pay page solicits parameters 
of a transacuon. Then, the parameters are validated to be sure the payment instrument, for 
example, cardnumber is not null. Then, a transaction object is created, eg. AUTHONLY, and 
the object is initialized and stuffed with parameters of the transacuon, eg. ao.setpan(accnum), 
and the object is executed. This execution invokes the vPOS engine. The vPOS engine further 
validates the parameters based on the particular merchant's configuration. For example, some 
merchans do not accept American Express Cards, but will take Visa, and all merchants check 
the expiration date of the card. Assuming a valid and acceptable card has been tendered, then 
a TID is assigned (expiring, existing TIDs) or block a new TID from the TID Pool. This generates 
a STAN, XID, RRPID unique tag and creates an initial record in the transaction database which 
is flagged as before gateway processing in case the transaction crashes and must be backed 
out. Then the protocol parameters are identified in the registry based on card type* and a 
particular acquirer identified. Then, a protocol object is created and executed to extract results 
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from the protocol object and the before gateway "bit" is flipped to again flag the location of the 
transaction in the process as it is submitted to the Gateway. 

The results received back from the Gateway are placed into a transaction object with is 
5 reported back to the pay page and ultimatey back to the pay page user. 



vPOS Merchant Pay Customization 

A novel feature of the vPOS software provides payment page customization based on a 
1 0 merchant's preferences. This feature automatically lists cards that are accepted by a particular 
merchant based on the active terminal configuration. Each approved card for a particular 
merchant is linked to the display via an URL that provides a pointer to the credit card 
information supported by the merchant. Each card has an entry in a data structure referred to 
as the Card Definition Table (CDT). 

15 

A preferred embodiment of the vPOS merchant pay customization software in accordance with 
a preferred embodiment is provided in Figure 19 which illustrates the logic utilizing a 
flowchart, and a listing of the source code below. Processing commences at terminal 1900 and 
immediately flows to function block 1910 where an index variable is initialized for stepping 

20 through each of the accepted payment instruments for the merchant's page. Then, at function 
block 1930, a URL key is obtained associated with the current merchant pay page and index 
value. The URL key is a registry key name that points to a picture of a credit card that the 
merchant has associated with the pay page and which the merchant accepts as payment. At 
output block 1940 the card image associated with the URL key is obtained and displayed on 

25 the terminal. The CDT entry is obtained at function block 1950 utilizing the URL key. The 
CDT is utilized for storing information associated with each card. Then, at decision block 
I960, a test is performed to determine if the last payment method card has been processed 
and displayed on the merchant display. If not, then the index is incremented at function block 
1920 and the loop reiterated to process the next card at function block 1930. If all the cards 

30 have been processed, then control is returned to the merchant program for processing the 
transaction at terminal 1970. 
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Figures 20A through 20H are block diagrams and flowcharts setting forth the detailed logic of thread processing in 
accordance with a preferred embodiment. Figure 20A illustrates a prior art approach to POS processing utilized in 
most grocery stores and department stores today. POS Terminal 2001 accepts transactions provided to it one at a 
time by customers 2000. For each transaction, POS Terminal 2001 builds a transaction request 2002 and transmit it 
5 to acquiring bank 2004 over communications link 2003. 

Figure 20B is a data structure 2002 representing a POS transaction request in accordance with a preferred 
embodiment. The data structure 2002 includes a T1D field 2005, which identifies the physical terminal from which 
the transaction originates, in addition to the T1D field, the data structure also includes other data 2006 necessary to 
1 0 process a transaction. This data includes such fields as a transaction type, a transaction amount, a currency type 
(such as U.S. dollars), credit card account number, credit card expiration date, etc. 

Figure 20C illustrates a vPOS architecture with account requests being processed by a single acquiring bank. vPOS 
2007 processes a plurality of customers 2000 concurrently. For each such customer 2000, vPOS 2007 builds a data 
1 5 structure 2010, representing the transaction to be performed for that customer. Each data structure 2010 contains a 
unique 'Virtual terminar ID. vPOS 2007 selects a virtual terminal ID using database 2008. For each data structure 
2010, vPOS 2007 initiates communication with acquiring bank 2004 using communication link 2003. 

Figure 20D is a data structure 2010 representing a vPOS transaction requesi in accordance with a preferred 
20 embodiment. The data structure 2010 includes a TID field 2012, which identifies a virtual terminal ID associated 
with a particular transaction. In addition to the TID field 2012, the data structure also includes other data 2006 
necessary to process a transaction. This data includes such fields as a transaction type, a transaction amount, a 
currency type (such as U.S. dollars), credit card account number, credit card expiration date, etc. 
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Figure 20E illustrates a TID allocation database 2008 in accordance with a preferred embodiment. Database 2008 
includes a TID allocation table 2011. TID allocation table 201 1 includes a plurality of rows, one for each TID used 
by each acquiring bank. One such row 2013 is illustrated in detail. Row 2013 includes a good/service order (GSO) 
identifier 2014. which identifies the order being transmitted; a TID field 201 5, which identifies a terminal ID that 
5 may be used with a particular acquiring bank; and an acquiring bank field 2016. which identifies the acquiring bank 
for which the TID is valid. In addition, row 2013 may optionally include other fields 2017 that may be used in 
conjunction with the order processing. A null GSO value indicates that the TID/Acquirer combination is not 
currently in use. 

10 Figures 20F through 20H are flowcharts of the detailed logic used to perform virtual terminal ID allocation. Figure 
20F illustrates the main line operation of virtual TID allocation. In step 2020, execution begins. In step 2021, a 
skeletal transaction request structure is prepared. In step 2022, the main line routine obtains a virtual TID for 
inclusion within the transaction request structure, as will be more fully disclosed with reference to Figure 20G, 
below. In step 2023, the routine verifies that a TID was obtained. If the TID was not obtained, for example, if more 

1 5 transactions are currently being processed than there are TIDs, then execution continues to step 2024. In step 2024. 
the transaction request is put on a queue for future processing. In step 2025, the routine waits for a transaction 
process to end. which would free up a TID in use. At that point, controi resumes from step 2022, and the routine 
again attempts to obtain a TID. 

20 If the TID was successfully obtained in step 2023, control proceeds to step 2026. In step 2026, the routine submits 
the transaction to the acquiring bank. In step 2027, the transaction is processed. )n siep 2028, the routine makes a 
database call to free up the TID that was used in the transaction, in step 2U29 ; transaction processing ends. 
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Figure 20G depicts in detail the process of obtaining a TID from the database. Execution begins in step 2040. In 
step 2041. the routine constructs a database call to reserve a TID for processing, for example, by constructing an 
SQL statement to retrieve a TID row from the database, in step 2042, the routine executes the database call that was 
constructed in step 2041. In step 2043, the routine constructs a second database call to extract the TID from the row 

5 that was reserved in step 2042. In step 2044, the database call constructed in step 2043 is executed to obtain the 
TID. In step 2045, a return code is checked to verify whether the TID was successfully obtained. If the TID was 
successfully obtained, control proceeds to step 2046, which returns to the calling program. If. however the TID was 
not obtained, control proceeds to step 2047. In step 2047, the routine checks to see whether an excessive number of 
retries have already been attempted. If there have been an excessive number of retries, control proceeds to step 

10 2048, which exits with an error indication. If there has not been an excessive number of retries, control proceeds 
once again to step 2043 to retry the extraction operation. 

Figure 20H depicts the operation of releasing a TID that had been used in a prior transaction. Execution begins in 
step 2060. In step 2062, the routine constructs a database call to update the row for the selected TID so that the 
1 5 value for the good and service order is null, thereby indicating that the selected TID is not associated with any good 
or service order, and is therefore free for reuse. In step 2064, the routine executes the SQL statements constructed 
in step 2062. thereby releasing the TID for use in future transactions. In step 2069. the routine returns to the calling 
program. 

20 A source code listing for the transaction request processing is provided below in accordance with a preferred 
embodiment. 



25 



#include "rr.h" 
#ifhdef_NT 
#define .NT 
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extern void _setenvp(); 
#endif 

///////////////////////////////////////////////////////////^^ 
/ / AcquireBillHtml 

/ / On Pay page, output form entries to acquire billing information 

//////////////////////////////////////////////////////////////z 

EStatus AcquireBillHtml(CWSINT& clWSINT, int nTot, CProffc clProfile, EPCLCurrency 
eCurrency) ( 

//Current time 

time J: tNow; / /figure out current year for Credit card expiry 

struct tm *tmNow; 

char szYear [ D B_YE A R_SZ +1); 

char szAmount(FORMATTED_CURRENCY +1]; 

time(&tNow); 

tmNow = local time(&tNow); 

strftime(&szYear[0|, (size_t)DB_YEAR_SZ + 1, "%Y\ tmNow); / /needs extra 1 for null 
int nYear - atoi(szYear); 
/*<TH>Payment Type </TH>\n<TD>< INPUT SIZE = 20 NAME=b_instrument VALUE= V" \ 

« clProfile.m_b_instrument « "V></TD>" \ 

« -/ 

clWSINT « "<CENTER><TABLE BORDER=0><CAPTlON ALIGN » TOP><B>Bill 

To</B></CAPTION>\n"; 

clWSINT « " <TR AUG N=LEFT><TH> Account Number</TH><TD COLSPAN - 5><INPUT 

SIZE = 56 MAXLENGTH = " 

« ACCT_NUM_SZ « " NAME*b_card> </TD></TR>\n"; 
clWSINT « "<TR ALIGN=LEFT><TH>Name on Card</TH><TD><INPUT SIZE- 20 

MAXLENGTH= " « NAME^SZ 

« M NAME=b_name VALUE=V* « clProfile.m_b_name 

« -\"> </TD><TH>Expirauon</TH><TD> Month < SELECT NAME « 

b_expire__month><OPTION> 01 \n <OPTION> 02\n M « 
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"<OPTION> 03\n <OPTlON> 04\n<OPTION> 05\n<OPTION> 06\n<OPTION> 
07\n<OPTION> 08\n<OPTION> 09\n H « 

"<OPTION> 10\n<OPTION> il\n<OPTION> 1 2 \n</SELECT> Year < SELECT 
NAME = b_expire _year>< OPTION >" « nYear « 

"<OPTION>'' « nYear + 1 « '^OPTION:*'* << nYear + 2 « ,, <OPTION>" « nYear 
+ 3 « "<OPTION>" « nYear + 4 « 

M < /SELECT></TD></TR>\n"; 
//<TH>Expires</TH><TD>Month <INPUT SIZE-3 NAME=b_expire_month> Year <INPUT 
SIZE=5 NAME-b^expire_year></TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFTxTH> Address Line 1</TH><TD COLSPAN-5><INPUT 
SIZE=56 MAXLENGTH- " « ADDR.SZ 

« " NAME=b^addrl VALUE=V" << cl Profile. m.b_addrl « "\"> </TD></TR>\n"; 
clWSINT « "<TR ALIGN « = LEFT><TH>Address Line 2</TH><TD CO LS PAN = 5 >< 1 N PUT 
S1ZE-56 MAXLENGTH= " « ADDR_SZ 

« " NAME=b_addr2 VALUE=\"" << clProfile.rnJ)_addr2 « "\"> </TD></TR>\n"; 
clWSINT « "<TR ALIGN =s LEFT><TH>City< /TH><TD><INPUT MAXLENGTH= " « 
CITY_SZ « " NAME=b_city VALUE=\ M " 

« clProfile.m_b_city « "\"> </TD>" « "<TH>State/Province</TH><TD><INPUT 

MAXLENGTH= " « STATE.SZ 

« " NAME=b_state VALUER" « clProfile.m_b_state « "\"> </TD></TR>\n"; 
clWSINT « "<TR ALIGN-LEFT><TH>Country</THxTD><lNPUT MAXLENGTH= " « 
COUNTRY_SZ 

« " NAME=b_country VALUE- V" « clProfile.mJ>_country « "\"> 
</TD><TH>Zip/Postal Code</TH><TD><INPUT MAXLENGTH= " 

« ZIP.SZ « " NAME s b_zip VALUER"' « clProfUe.m_b.zip « " \*> 
</TD></TR>\n"; 

clWSINT « "<TR ALlGN=LEFTxTH>EmaiK/THxTDxlNPUT MAXLENGTH 82 " « 
BEMA1L.SZ « " NAME«b_email VALUE* V" 

« clProfile.m^b.email « T> </TD>" « "<TH>Phone</TH><TD>< INPUT 

MAXLENGTH= " « BPHONE_NUM_SZ 

<< " NAME=b_phone VALUE- V" « clProfde.rn_b_phone « "\"> 
</TD></TR>\n"; 
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clWSINT « "</TABLE></CENTER><P>\n ,t ; 

//NPW« " NAME=b_addrl> </TD>" « M <TH> Payment 
Instrument</TH>\n<TD><SELECT NAME =b_instrument> rt ; 
5 / /hack from ini (bug) which pay instruments supported 

/ /NPW clWSINT « "<OPTION> Credit Card\n" « "<OPTION> Debit 
Card \ n</SELECT></TD>< / TR> \n " ; 

CurrFormatfnTot, eCurrency, szAmount); 

clWSINT « "<CENTER><FONT SIZE=5>Total = " << szAmount « 
10 "</FONT>< / CENTER>" ; 

return (eSuccess); 

( 

iiuiiiitiiuuiiuiiitiuiuiuiutiuuuunuiiminuuii 

15 //PayButtonsHtml 

// Output buttons on pay page: return to shop, pay, pay window, 
/ / modify order 

iiiiiiiiitiitiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiim 

void PayButtonsHtml(CWSINT& clWSINT, char* pszShopUrl, CRRReg& clReg) { 

20 

char *pszHomeUrl » clWSINT.LookUpfhome^urr); 
char *pszModifyUrl = clWSINT. Loo kUp("modify_urr); 
char *pszSoftUrl = clWSlNT.LookUpC'soft.urr); 

25 if (IpszHomeUrl) pszHomeUrl pszShopUrl; //Home Page 

//if (IpszModifyUrl) pszModifyUrl = pszShopUrl; //Shopping Cart typically 

clWSINT « "<CENTER><H4>By pressing the Pay! button I agree to pay the above total 
amount<br> according to the card issuer agreement<H4></CENTER> \n"; 
30 clWSINT « "<CENTER>\n<A HREF = " « pszShopUrl « > <IMG SRC=" « 

clReg.m.szReturnShop « " BORDER « 0></A>\n w ; 
#ifdef_SC 
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clWSINT « "< INPUT TYPE = IMAGE NAME = gso SRC = " « clReg.m^szModifyOrder << 
* BORDER ■ 0>\n"; 
#else 

if (pszModifyUrl) 

5 clWSINT « "<A HREF = " « pszModifyUrl « "> <IMG SRO" « 

clReg.m.szModifyOrder « M BORDER = 0></A>\n"; 
#endif 

clWSINT << "<INPUTTYPE * HIDDEN NAME - home.url VALUE » " « pszHomeUrl « 

">\n" 

10 « "<INPUT TYPE = IMAGE NAME = vPOS SRC = " « clReg.m_szPay << " BORDER - 

0>\n" 

« "<INPUT TYPE - HIDDEN NAME = shop_url VALUE * " « pszShopUrl « ">\n" 
« "< INPUT TYPE = HIDDEN NAME = store VALUE = " << clWSINT. LookUpf store") «. 
">\n"; //Can't be NULL or error previously 
15 if (pszSoftUrl) 

clWSINT « "<INPUT TYPE = HIDDEN NAME = soft, url VALUE = " « pszSoftUrl 

« ">\n"; 

clWSINT « "< / CENTER> \n" ; 

} 

20 lllllllllllllltllllllltlllllllllllltlllllllllllllllllllllllllll 
(I Display Pay Page 

/ / Outputs billing form, buttons, and static gso 

/////////////////////////////////////////////////////////////// 
EStatus DisplayPayPage(CWSINT& clWSINT, CRRRegfc clReg, int nError) { 

25 

EStatus eStat; 

char szFileLine[BUFFER_SZ + 1); 

char *pszTag, *pszRefererUrl, *pszShopUrl, 'pszExePath, "pszServerName; 
time_t tNow; 
30 int nTagExist » FALSE; 

HKEY hCardsKey; / /To enumerate cards 
long retCode; 
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int nNoCards; 
DWORD dwtype, dwlen; 
HKEY hCardKey; 

char szCardBuf]MAX_PATH + 1|, szCardPic[MAX_PATH + 1]; 

5 

#ifdef_SC 

CPOLBk clBkGso; 

#else 

char *pszTxn, *pszGsoNum, *pszGsoOpaque, *pszTot; 

10 #endif 

//Shipping headers. If come from gso page and cookies are not set, set. 
CProf *pProfile; 
pProfile - new CProf(); 
1 5 if (IpProfile) return (eRRNewFailed); 

eStat = pProfile->Init(clWS!NT); 

if (eStat eSuccess) return (eStat); //Init failed 

#ifdef _SC /*No session cookie for the pay page. This means the user will either use a long 
20 term cookie or type in their info each time*/ 

clWSINT « "Set-Cookie: profile*" « pProfile->GetCookieLine() « "; path=/\n"; 
/ * if (clWSINT.LookUpf Server Name")) 

clWSINT « domain = * « clWSINT. ix>okUpf' Server Name") « ";\n";*/ 

#endif 

25 

#ifdef_SC 

/ / Shipping filled in? 

if (!(pProfile->m_s_namejO] && pProfile->m_s_addrl[0] && pProfile->m_s_city|0] && 

pProfile->m_s_state[0) && 
30 pProfile- >m_s_zip[0] && p Profile- >m_s_coun try [0] && pProfile->m_s_ship[0])) { 

eStat = DisplayGsoPage(clWSINT, clReg, ERROR.DISPLAY); //bug, return 

correct? 
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return eStat; 

} 

//Creates shopping basket from CGI /Cookies 

eStat - clBkGso.initfciWSINT, *pProfile, ciReg); 

if (eStat !* eSuccess) return (eStat); //eRRBasketCreateError 

//Cookies then other headers 
ciBkGso.ToCookies(clWSINT, REGULAR); 

#endif 

//clWSINT « "Pragma: no-cache\n H ; 
clWSINT « "Content-type: text/html\n\n"; 

//Where to position the page, if all information is filled in, here, 
if (InError) (clWSINT « "<A NAME=jump></A> M ;} 

//Output HTML 
ifstream ifPay; 

ifPay.open(clReg.m__szPayTemplate, ios::in | ios::nocreate); 

if (ifPay.fail()) return (eRRCantOpenPayTemplate); //couldn't read pay template file 

//HTML Template 
while (ifPay) ( 

ifPay.getline(szFileLine, BUFFER.SZ); 

if (UpszTag « strstr(szFileLine, DYNAMIC _TAG))) 
clWSINT « szFileLine « M \n n ; 

elsej 

nTagExist * TRUE; 

/ /Null the tag, Output the beginning of the line, 
/ / make the dynamic basket call, output the rest of the line 
if (strien(szFileLine) == strlen(DYNAMIC_TAG)) 
pszTag[0j = NULL; 
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else { 

pszTagjO] - (char) NULL; 

pszTag += strlen(DYNAMICJTAG) + 1; //was 9 

I 

5 clWSINT « szFileLine; 

//Dynamic call 

pszRefererUrl = clWSINT.LookUpCReferer"); 

if (IpszRefererUrl) return (eRRNoRefererUrl); 

pszExePath * clWSINT. LookUpf Executable Path"); 
10 if (IpszExePath) return (eRRNoExePath); 

pszServerName * clWSINT.LookUpfServer Name"); 

if (IpszServerName) return (eRRNoServerName); 

clWSINT « "<FORM METHOD - POST ACTION = http"; 

if (clReg.m.nUseSSL) 
15 clWSINT « "s"; 

clWSINT « "://" « pszServerName « pszExePath << "#jump>"; 



,, #jump>";*/ 

20 



/'clWSINT « "<FORM METHOD - POST ACTION = " << pszExePath << 



/ / Setting Long Cookies 

clWSINT << "<CENTER>If you wish to have billing and shipping defaults 
set in your browser, check this box " 

« "<INPUTTYPE « CHECKBOX 
25 NAME=long_cookies></CENTER>\n"; 

//Fill it in message 
if (nError) { 

clWSINT « "<A NAME=jump> < / A>" ; 

clWSINT « "<CENTER><H4>You must nil in <I>ali</l> of the 
30 billing information except for <I>address line 2</I> and <I>email</I>.</H4></ CENTERS; 

} 

//GsoNum 
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#ifdef_SC 

time(fittNow); // For multithreading, append instantiation number 
clWSINT « "<TABLE ALIGN=RIGHT><TR><TH>Order 

Number</TH><TD>" « tNow 
5 « "</TD>< /TR>< /TABLE>< BR CLEAR -ALL>\n< INPUT 

TYPE S HIDDEN NAME=b_gso_num VALUE = " « tNow « ">\n"; 

#else 

//Pay page API: transaction type, GSO #, gso opaque 
pszGsoNum ■ clWSlNT.LookUp("b_gso_num"): 
10 if (pszGsoNum) 

clWSINT « "<TABLE ALIGN s =RIGHT><TR><TH>Order 
Number< /TH><TD>" << pszGsoNum 

« "</TD>< /TR>< /TABLE><BR CLEAR=ALL> \n<iNPUT 
TYPE-HIDDEN NAME=b_gso_num VALUE = " « pszGsoNum « ,, >\n ,t ; 
15 else{ 

time(&tNow); //For multithreading, append instantiation number 
clWSINT « "<TABLE ALIGN ss RIGHT><TR><TH>Order 

Number</TH><TD>" « tNow 

« "</TD></TR>< /TABLE >< BR CLEAR «ALL> \n< INPUT 
20 TYPE-H1DDEN NAME-b_gso_num VALUE = " « tNow « ">\n"; 

) 

//Some pay page only specifics: transaction to execute, gso opaque 
pszTxn = clWSINT.LookUpf transaction'); 
if (pszTxn) 

25 clWSINT « "<INPUT TYPE=HIDDE^ NAME=transaction VALUE » 

" << pszTxn << ">\n"\ 

pszGsoOpaque * clWSINT.LookUpf gso_ opaque"); 
if (pszGsoOpaque) 

30 clWSINT « <INPUT TYPE-HIDDEN NAME=gso.opaque VALUE = 

V" « pszGsoOpaque << M \ M >\n"; 
#endif 
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#ifdef_SC 

//Bill to information & Payment Instrument 
eStat = AcquireBiUHtml(clWSINT, clBkGso.GetTot(), 'pProfile, 
5 (EPCLCurrency) clReg.rn.eDefaultCurrency); 
#else 

//Pay Page alone requires a total 
pszTot * clWSlNT.LookUpf total*); 
if (IpszTot) return (eRRNoPayTotal); 
] 0 eStat = AcquireBillHtmlfclWSINT, atoi(pszTot), 'pProfile, (EPCLCurrency) 

clReg. m_eDefaultCurrency) ; 

clWSINT « "<INPUT TYPE=HIDDEN NAME=total VALUE = " « pszTot « 



15 



">\n"; 
#endif 

AcquireBillHtml 



if (eStat != eSuccess) return (eStat); //error from db? within 
clWSINT« M <P>\n"; 



20 



25 



Accepted:</TH> M ; 



30 fchCardsKey); 



//Output Buttons on Form 

pszShopUrl - clWSINT.LookUpCshop.urr); 

if (IpszShopUrl) 

PayButtonsHtml(clWSINT, pszRefererUrl, clReg); 

else 

PayButtonsHtml(clWSINT, pszShopUrl, clReg); 
//Registry Card LookUp 

clWSINT « "<CENTER><TABLE CELLSPACING = 5><TR><TH>Cards 
RegOpenKeyExfclReg.mJiStoreKey, "API\\CDT , 0, KEY^READ, 
dwlen - sizeof(int); 

RegQueryValueEx(hCardsKey, "NoOfRows", 0, fcdwtype, 
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(LPBYTE)fcnNoCards, fcdwlen); 

for (int i - 0; i < nNoCards; i++) { 

RegEnumKey(hCardsKey, i, szCardBuf, MAX_PATH + 1); 
RegOpenKeyExfhCardsKey, szCardBuf, 0, KEY.READ, 

5 &hCardKey); 

dwlen = MAX_PATH + i; 

retCode - RegQueryValueEx(hCardKey, XardPicture ",. 0, 
fcdwtype, (LPBYTE)szCardPic, &dwlen); 

if (retCode ERROR_SUCCESS) return eRRRegistry Failure; 
10 clWSINT « "<TD><IMG SRC = " << szCardPic « "></TD>"; 

RegCloseKey (hCardKey ) ; 

I 

RegCloseKey(hCardsKey); 
clWSINT « "</TR>< /TABLE ></CENTER>"; 
15 clWSINT « "</FORM>\n<HR>\n"; 



20 



25 



#ifdef_SC 



#else 



#endif 



//Output static HTML Table 
clBkGso.ToHtml(clWSINT, NOEDIT); 
//Output static Shipping information 
StaticShipHtmlfclWSINT, *pProfile); / /Also NO.EDIT 
clWSINT « "<HR>\n p ; 

/ / Pay page alone takes and passes through a gso 
if (pszGsoOpaque) 

clWSINT « pszGsoOpaque « ' \n"; 

/ / Rest of Line from template file 
if (pszTag) clWSINT << pszTag; 



30 



if (nTagExist != TRUE) 
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return(eRRNoDynamicTag); 

else 

return (eSuccess); 

) 

5 

IIIIIIIIIIIIIIIIIIIIIIIIUIIIIII 

//Receipt Page 

iiiiiiiiiiiiiiitiiniiiiiiiniiiiiiiiiiinuiiniiiiiiitiiiiuitiutiiinuin 

////////////////*i«ef_SC 

io /////////////////////////////////////////////////////////////// 

// StaticShipHtml 

/ / On Pay page, output Static table of shipping information 
/ / based on cookies set in prior page 

/////////////////////////////////////////////////////////////// 
1 5 void StaticShipHtmi(CWSINT& clWSINT, CProf clProfile) { 

clWSINT « " < CENTER> <TABLE CELLSPACING=10><CAPTION ALIGN = TOP><B>Ship 
To<B></CAPTION>\n"; 

clWSINT « "<TR><TH ALIGN = s LEFT>Name</TH><TD>" « clProffle.m_s_name « 

"</TD>" « 

20 "<TH ALlGN=LEFT>Address Line 1</TH><TD>" « clProfile.m_s_addrl « 

"</TD></TR>\n"; - 

clWSINT « "<TR><TH ALIGN=LEFT>Address Line 2</TH><TD> M « clProfile.m_s_addr2 

« "</TD>" << 

"<TH ALlGN=LEFT>City< /TH><TD>" « clProfile.m_s_city « "</TD></TR>\n"; 
25 clWSINT « "<TR><TH ALIGN e LEFT>State/Province</TH><TD>'' << cl Profile. m_s_state 

« "</TD>" « 

"<TH ALIGN =LEFT> Zip/ Postal Code</TH><TD>" « ciProfile.m_s_zip « 
"</TDx/TR>\n"; 

clWSINT « "<TR><TH ALIGN=LEFT> Country < /TH><TD>" << dProfile.m_s_country « 
30 "</TD>"« 

"<TH ALIGN*LEFT>Shipping Method </TH><TD>" « clProfile.m_s_ship « 
"</TDx/TR>\n'*; 
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clWSINT « "</TABLE></CENTERxP>"; 

) 

#endif 

5 

/////////////////////////////////////////////////////////////// 
// StaticBillHtml 

//On Receipt page, output static table of billing information 

/////////////////////////////////////////////////////////////// 
! 0 void StaticBillHtml(CWSINT& clWSINT, CProf ciProfiie) | 

/*<TH>PaymentType</TH>\n<TD>" « clProfile.m_b_instrumem 
« "</TD>V 

clWSINT « "<CENTER><TABLE CELLSPACING=10>< CAPTION ALIGN * TOP><B>Bill 
15 To<B></CAPTION>\n M ; 

clWSINT « "<TR ALIGN ■= LEFTxTH > Account Number</TH><TD COLSPAN=3>" « 
clProfile.m_b_card « "</TD></TR>\n"; 

clWSINT << "<TR ALIGN=LEFT><TH>Name on Card</THxTD>" « clProfile.m_b.name 

<< 

20 "</TDxTDxB>Expires:</BxI>Month</I> - « clProfile.m_b_expire_month << 

" <I>Year</I> " « clProfile.m^b_expire_year « "</TD></TR>\n"; 

clWSINT « "<TR ALIGN=LEFT><TH> Address Line 1</TH><TD COLSPAN=3>*' « 
clProfile.m_b_addrl << "</TD></TR>\n"; 

clWSINT « "<TR ALlGN=LEFT><TH>Address Line 2</TH><TD COLSPAN=3>" « 
25 clProfile.m_b_addr2 « "</TDx/TR>\n"; 

clWSINT « "<TR ALIGN 0 LEFT><TH>City</TH><TD>" << cJProfile.m_b.city « "</TD>" 

« '^TH^tate/Province^THxTD^ « cl Profile. ro_b_state « "</TDx/TR>\n"; 
clWSINT << "<TR ALIGN«LEFTxTH>Country</TH><TD>'' « clProfile.m_b_country << 
"</TD><TH>Zip/Postal Code</THxTD>'' << cLProfile.m_b_zip « 
30 ,, </TD></TR>\n M ; 

clWSINT « "<TR ALIGN«LEFT><TH>Email</THxTD> « clProfile.m_b_email « 

"</TD>" 
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« "<TH>Phone</TH><TD>" « clProfile. m_b_phone « "</TD></TR>\n"; 
clWSINT « " < /TABLE>< / CENTERx P> \n" ; 



5 /////////////////////////////////////////////////////////////// 
//vPOSReceipt 

/ /Generates a receipt from the return block and profile info. 

/////////////////////////////////////////////////////////////// 
#ifdefvPOS_OLE 
10 #ifdef_SC 

void vPOSReceipt(CWSINT& clWSINT, /* CVPCLFinCCTrans */ 
CVPCL_01eCCAuthOnly *pTxn, CProf& clProfile, CRRRegfc clReg, CPOLBkfc clBkGso) { 
#else 

void vPOSReceipt(CWSINT& clWSINT, /* CVPCLFinCCTrans •/ 
1 5 CVPCLJMeCCAuthOnly *pTxn, CProffc clProfile, CRRRegfc clReg) { 
#endif 

#else 

#ifdef_SC 

void vPOSReceipt(CWSlNT& clWSINT, CVPCLFinCCTrans *pTxn, CProf& 
20 clProfile, CRRReg& clReg, CPOLBk& clBkGso) { 
#else 

void vPOSReceipt(CWSINT& clWSINT, CVPCLFinCCTrans *pTxn, CProffc 
clProfile, CRRRegfc clReg) { 
#endif 

25 #endif 

//Set Long cookies (if applicable) 
struct tm *tmNow; 

char szDate[32]; / /what is the max date? in this format/ bug 
time_t tNow; 
30 time(&tNow); 

tNow += clReg.m_nProfileLife * 86400;/ /ini constant for length of cookie stay 
tmNow - local time(&tNow); 
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strftime(szDate, (si2e_t)31, "%a, %d-%b-%y %H:%M:%S GMT, tmNow); 
if (clWSINT.LookUp( ,, long.cookics")) 

ciWSINT << "Set-Cookie: cust_profile=" « clProfile,GetCookieLine() « "; 

expire s=" 

« szDate « path=/\n"; //Profile cookies 

#ifdef _SC / /Shopping cart sets local cookies on receipt 

ciWSINT << "Set-Cookie: profile*" « clProfile.GetCookieLine() « "; expires* 
« szDate << path»/\n"; / /Profile cookies 

#endif 

/•ciWSINT « "; domain ■ " « clWSINT.LookUprServer Name") << "An";*/ 



#ifdef_SC 

//Delete shopping basket 
clBkGso.ToCookies(cIWSINT, EXPIRE); 

#endif 

ciWSINT « "Pragma: no-cache\n"; 
ciWSINT « "Content-type: text/ html \n\n"; 

ciWSINT « "<HTML><BODY " « clReg.m_szBackgroundString « ">\n"; 
ciWSINT « "<A N AME»jump>< / A> \n" ; 

ciWSINT « "<CENTER><IMG SRC=" « clReg.ra_szReceiptBanner « "></CENTER>\n" 
ciWSINT << "<CENTER><H2>This is your receipt. Please save it using the <I>Save 
As</I> option from the <I>File Menu</I> in your browser</H2></CENTER>"; 

//vPOS Return Block 

char szGso[PURCH_ORDER_NUM_SZ + 1); 

char szTransAmt[AMT_SZ + 1]; 

char szDisplayTransAmt[FORMATTED_CURRENCY + 1]; // Extra point for decimal 
enum EPCLCurrency eCurr;// - (EPCLCuirency) clReg.m_eDefaultCurrency; 
enum EPCLDecimals eDec;// - eTwoDecDigits; 
char szTime[TRANS_TIME_SZ + 1|; 
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char szPan(ACCT_NUM_SZ +1J; 

char szExpDate[EXP_DATE_SZ + 1); 

char szRe t RefN um[RET_RE F_NUM_SZ + 1]; 

P Txn->GetRespTransAmt(szTransAmt, AMT_SZ + 1, &eCurr, &eDec); 
P Txri->GetPurchOrderNum(szGso, PURCH_ORDER_NUM_SZ +1); 
P Txn->GetRespTransDate(szDate, TRANS_DATE_SZ + 1); 
P Txn->GetRespTransTime(szTime, TRANSJTIME.SZ +1); 
pTxn->GetRetRefNum(szRetRefNum, RET_REF_NUM_SZ +1); 
P Txn->GetPAN(szPan, ACCT_NUM_SZ +1); 
P Txn->GetExpDate(szExpDate, EXPJDATE_SZ+ 1 ); 

clWSINT <<"<CENTER><TABLE BORDER=0 CELLSPACING=10><CAPTION><B>" « 
clReg.m_szShopName 

<< " - Order Number</B> - " « szGso 

« "</CAPTION>\n<TR ALIGN=LEFT><TH>Time</TH><TD>" « szTime[0| 
« szTime[l] « ": M « szTime|2] « szTime[3) « ':" « &szTime(4] « 
,, </TD><TH>Date</TH><TD>" 

« szDate[0] « szDate[l| « 7" « szDate[2] « szDate[3] « 7" « &szDate[4] 

« "</TD></TR>" 

« "<TR ALIGN* LEFT> <TH > Account Number</TH><TD COLSPAN=3><B>" « 

szPan « "</B></TD></TD>" 

« "<TR ALIG N =LEFT> <TH > Authorization Code</TH><TD>" « M No Auth?" 
« "</TD><TH>Reference Number </TH><TD>" « szRetRefNum « 

"</TD></TR>" 

« "</TABLE></ CENTERS; 
CurrFormat(atoi(szTransAmt), eCurr, szDisplayTransAmt); 
clWSINT « "<CENTER><FONT SIZE=5>Total - " « szDisplayTransAmt « 
< / FONT>< / CENTER><HR> \n" ; 



/ /transtype, time, date, acct #, expire, vPOS id, transaction type, auth code, ref#, 
amount 
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//Soft goods fulfillment 

char 'pszSoftUrl =» clWSINT.LookUp("soft_url"); 
if (pszSoftUrl) 

clWSINT « pszSoftUrl « "<HR>"; 

#ifdef_SC 

//Static Gso, placeholder crap until do LnGrp 
clBkGso.ToHtmlfclWSINT, NOEDIT); 
clWSINT « "<HR>"; 
//Static Billing 

StaticBillHtml(clWSINT, clProfile); 
clWSINT « "<HR>"; 
//Static Shipping 
StaticShipHtml(clWSINT, clProfile); 
clWSINT « , <HR> W ; 

#else 

/ / Static passed gso if it exists 

char *pszGso = clWSINT. LookUpfgso_opaque"); 

if (pszGso) clWSINT « pszGso; 

//Static Billing 

StaticBillHtml(clWSINT, clProfile); 
clWSINT « "<HR>"; 

#endif 

//Merchant Signature Block (if/ when applicable) 
//Buttons 

char *pszHomeUrl - clWSINT.lx>okUp("home_urn; 

char 'pszShopUrl = clWSlNT.LookUpf'shop.urr}; 

clWSINT « "<CENTER>\n<A HREF = " « pszShopUrl 

« "> <IMG SRC=" « clReg.m_szReturnShop « " BORDER = 0></A>\n M 

<< "<A HREF - " « pszHomeUrl << "> <IMG SRC=" « clReg.m_szHome « " BORDER 
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0></A>\n" 

« " < / CENTER><HR> \ n" ; 

/ /Acquirer Banner 

5 char szPANLo[ACCT_NUM_SZ + 1), szPANHi[ACCT_NUM_S2 - 1], szBufIMAX_PATH + 1]; 

char szTruncPAN[ACCT_NUM.SZ+ 1 ] ; 
HKEY hCardsKey, hCardKey; 
DWORD dwtype, dwlen; 
int nNoCards, nPANLen; 
10 longretCode; 

RegOpenKeyEx(clReg.m_hStoreKey, "APIWCDT", 0, KEY.READ, fchCardsKey); 
dwlen = sizeof(int); 

RegQueryValueExfhCardsKey, "NoOfRows", 0, fcdwtype, (LPBYTEJ&nNoCards, fcdwlen); 
for (int i = 0; i < nNoCards; i++) { 
15 RegEnumKeyfhCardsKey, i, szBuf, MAX_PATH + 1); 

RegOpenKeyEx(hCardsKey, szBuf, 0, KEY_READ, fchCardKey); 

dwlen = ACCT_NUM_SZ + 1; 

retCode - RegQueryValueEx(hCardKey, "PANLo", 0, fcdwtype, (LPBYTE)szPANLo, 

fisdwlen); 

20 if (retCode !- ERROR.SUCCESS) return; 

dwlen - ACCT_NUM_SZ + 1; 

retCode = RegQueryValueEx(hCardKey, "PANHi", 0, fcdwtype, (LPBYTE)szPANHi, 

&dwlen|; 

if (retCode != ERRORJ3UCCESS) return; 
25 nPANLen - strlen(szPANLo) ; 

strncpy(szTruncPAN, szPan, nPANLen), 
szTruncPAN[nPANLen] = '\0' i 

if((atoi(szTruncPAN) >= atoi(szPANLo) ) && (atoi(szTruncPAN) <- atoi(szPANHi))) | 
char szAcquirer[MAX_PATH + 1), szAcquirerBannerjMAX_PATH + 1); 
30 szAcquirer|01 = NULL; szAcquirerBanner[0] - NULL; 

HKEY hAcquirersKey, hAcquirerKey; 
int nNoAcquirers = 0; 
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dwlen = MAX.PATH + 1; 

RegQueryValueEx(hCardKey, "Acquirer", 0, &dwtype, 
(LPBYTE)szAcquirer, fcdwlen); 

RegOpenKeyEx(clReg.m_hStoreKey, M API\\ADT\ 0, KEY.READ, 

5 &hAcquirersKey); 

dwlen = sizeoffint); 

retCode = RegQueryValueEx(hAcquirersKey, "NoOfRows", 0, &dwtype, 
(LPBYTE)&nNoAcquirers, &dwlen); 

for (int j * 0; j < nNoAcquirers; ! 
10 retCode = RegEnumKey(hAcquirersKey, j, szBuf, MAX_PATH +1); 

//Get jth Acquirer subkey in szbuf 

if (retCode != ERRORJ5UCCESS) break; 
if (!strcmp(szBuf, szAcquirer)) { 

RegOpenKeyEx(hAcquirersKey, szBuf, 0, KEY.READ, 

15 fi&hAcquirerKey); 

dwlen = MAX_PATH + 1; 

retCode = RegQueryVaiueEx(hAcquirerKey, 
"AcquirerBanner", 0, fcdwtype, (LPBYTE)szAcquirerBanner, &dwlen); 

if (retCode != ERROR_SUCCESS) break; 
20 clWSINT « "<CENTER><IMG SRC=" « szAcquirerBanner 

« , ■></CENTER>\n ,, ; 

RegCloseKey (hAcquirerKey ) ; 
break; 

t 

25 ( 

RegCloseKey (hAcquirersKey ) ; 
break; 

} 

RegCloseKey(hCardKey); 

30 | 

RegCloseKey(hCardsKey); 
clWSINT « "</HTML>"; 
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5 IllllllllltllllllllllillllllllllllllllllllllllllllllllllllllUI 
II vPOSPay 

/ / Create a PO object and invoke the vPOS 

/////////////////////////////////////////////////////////////// 
EStatus vPOSPay(CWSINT& clWSINT, CRRRegfc clReg) { 

10 

EStatus eStat; 
EPCLTransType eTxn; 

char *ps2Txn = clWSINT.LookUp(" transaction"); 

char szBuf]MAX_CGI_VAR + 1|; //used for cgi variable tstore and for number later 
15 #ifdef_SC 

CPOLBk clBkGso; //GSO data structure 

#else 

/ /Total for transaction 
char *p&zTotal - clWSINT.LookUp(" total"); 
20 if (IpszTotal) return (eRRNoPayTotal); 

#endif 



/ / Profile object 
CProf *pProfile; 
25 pProfile = new CProf{); 

if (IpProfile) return (eRRNewFailed); 
eStat = pProfile->Init(clWSINT); 
if (eStat != eSuccess) return (eStat); 

30 / / Check billing information 

if (!(pProfile->mj5_narne[0] &&. pProfile->mJ)_addrl[0] && pProfile->m_b_city[0] && 

prYofile->ni_b_state(0] && 



WO 98/05011 



- 134- 



PCTYUS97/13673 



pProfile->mj3_zip[0] && pProfile->m_b_countrylO] && pProfile->m_b._phone[0] 

&& 

pProfile->m_b_card[0] && pFtofile->m_b_expire_month(01 && pProfile- 
>m_b_expire_jear[0])) { 

eStat = DisplayPayPage(clWSINT, clReg, TRUE); 
return eStat; 

1 

//Payment transaction for a credit card 
#ifdef vPOSJDLE 

CVPCL.OleCCAuthOnly *pTxn; 

#else 

CVPCLFinCCTrans *pTxn; 

#endif 

if (pszTxn) ( 

eTxn » eNumTransTypes; 
if (!strcmp("authonly'\ ps^Txn)) 
eTxn = eTransAuthOnly; 
/ * if (Istrcmpfauthcapture" , ps^Txn)) 

eTxn - eTransAuthCapture; 
if (Istrcmpfofflineauth", ps^Txn)) 

eTxn » eTransOfflineAuth;*/ 

I 

else 

eTxn = clReg.m_eDefaultAuthT rans; 

//Create Transaction object 

switch (eTxn) ( 

case eTransAuthOnly: 

#ifdefvPOS_OLE 

pTxn = new CVPCL_01eCCAuthOnly(); 
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#else 

pTxn = new CVPCL_CCAuthOnly(); 

#endif 

if (IpTxn) return eFailure; // Transaction Init Failure 

break; 
default: 

return eRRIllegalTransaction; 

i 

//Transaction Initialize 

char *pszMerchant - clWSINT.LookUpf store"); 
sprintf(szBuf, "MerchNarne= M ); 

strncat(szBuf, pszMerchant, (MAX_CGI_VAR-10)); / /The 10 is for MerchName= 

/ / Connect to the OLE Automation Server 
#ifdefvPOS_OLE 

eStat - pTxn->CreateDispatch() ; 
if (eSuccess != eStat) { 
return eFailure ; 

} 

#endif 

eStat - pTxn->InitTrans(szBuf); 

if (eStat !« eSuccess) return eFailure; //eRRTxnlnitFailed 
//GSO Number 

char* b_gso_num - cMS^-Lo^kUpC'D^so^num"); 
if (!b_gso_num) return (eRRNoGsoNum); 
//Compose Gso object 
/ /CPOLPO clPO(&b_gso_nurn); 

/ /Creates shopping basket from CGI/ Cookies. This information is borrowed by 
//Line Group class. For each item in the basket, put it in the PO object. We use a 
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member function 

/ /That others using the library cannot use because they may not have a basket object 
at their disposal. 

/ /Those others must use the Set methods directly 

/ /Then get prices from database. If prices differ, error code 
#ifdef_SC 

eStat «= clBkGso.Init(clWSINT, *pProfile, clReg); 
if (eStat != eSuccess) return (eStat); 
/ / eStat - clPO.InitFromBk(clBkGso); 
if (eStat != eSuccess) return (eStat); 

#endif 

//set all stuff from profile object 

//set custcookie 

//set cust id 

/ / set personal message 

/ /Pay Page standalone. Call an integrator function, execute vPOS stuff, call an ending 
function. 

/ /The calls before and after are for the integrator to reconcile his database with the 

vPOS. 



//GSO VERIFICATION suggestions 

/ / Check to see if this purchase order exists in the database & if it is linked properly 
with this price 

/ /Insert GSO and line items into db with before vPOS Txn status 
/ /eStat = GsoVerify(b_gso_num, pszTotal); / /For integrator to fill in. 
//if (eStat eSuccess) return eStat; //Failed lookup check 



#ifdef_SC 

int nTot; 

/* nTot = clBkGso.GetTotf) * 100; 

if (((clBkGso.GetTotO * 100) - nTot) .5) 
++nTot; 
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sprintf(szBuf, "%.2T\ nTot/ 100.0) ; //Transaction Amount, hack to get past 2 digits*/ 
/ /erase szBuf below. Lose precision by flooring this integer, need to define round 
up/down 

sprintf(szBuf, M %d\ (int)clBkGso.GetTot(J); 
5 pTxn^SetReqTransAmtlszBuf, (EPCLCurrency) cIReg.m_eDefaultCurrency, 

eTwoDecDigits); 
#else 

/ / Amount 

NumClean(pszTotal); 

1 0 pTxn->SetReqTransAmt(ps2Total, (EPCLCurrency) cIReg.m_eDefaultCurrency, 

eTwoDecDigits); 
#endif 

//GSO Num 

pTxn->SetPurchOrderNum(b_gso_num); 
15 //Retry Counter 

pTxn->SetRRPid(l); //The first time a transaction is executed this must be set to 1 

//AVS Data 

if (clReg.m_nAVS) { 

char avs_zip[ZIP_SZ + 1|; 
20 strncpy(avs_zip, pProfile->m_b_zip, ZIP_SZ); 

avs_zip[ZIP_SZ] = NULL; 

Num Clean (avs_zip); 

pTxn->SetAVSData(avs_zip); 

) 

25 pTxn->SetBName(pProfile->mJ>_name); 

pTxn- > SetBStreetAddress 1 (pProfile->m Jb.addr 1 ); 

pTxn->SetBStreetAddress2(pProfile->m„b_addr2); 

pTxn-> SetBCity (pProfile->m_b.city ); 

pTxn->SetBStateProvince(pProfiie->m_b_state); 
30 pTxn->SetBZipPostalCode(pProfile->m_b_zip); //Insert as is zip into db 

pTxn->SetBCountry(pProfile->m_b.country); 

pTxn->SetBEMail(pProfile->mJ>_email); 
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pTxn^SetBDayTimePhonelpProfile^m.b^phone); 

//Card Number and expiry date 
NumClean(pProfile->m_b_card); 
char szDate[DB_MONTH_SZ + DB_YEAR_SZ + I J; 
stmcpy(s2Date t pProfile->m_b_expire_month t DB_MONTH_SZ); 
szDate [ DB_MO NTH_SZ] = NULL; 

strncat(szDate, pProfile->m_b_expire_jear, DB_YEAR_SZ); 
pTxn->SetPAN(pProfile->m_b_card); 
pTxn->SetExpDate(szDate); 

//Execute Transaction 
eStat - pTxn->ExecuteTrans(); 

if (eStat != eSuccess) return eStat; //DB or Internal Error of some kind 
15 

/ /Transaction Shutdown 

eStat = pTxn->ShutDownTrans(); 

if (eStat !- eSuccess) return eFailure; //eRRTxnShutFaiied 

20 / /Gso after for integrator to fill in 

/ /Gso_reconcile(success or failure, gso_number); 

/ / Delete cookies GSO. Set shipping/ billing cookies. Send receipt - member function of 
PO object. 
25 #ifdef_SC 

vPOSReceipt(clWSINT, pTxn, 'pProfue, clReg, clBkGso); //This should be PO object 

#else 

vPOSReceipt(clWSINT, pTxn, *pProfile, clReg); / /Use Get Methods for Receipt 

#endif 
30 #ifdefvPOS_OLE 

/ / Disconnect from the server 
pTxn->ReleaseDispatch() ; 



5 



10 
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#endif 

return (eSuccess); 



Default Oateway Configuration 

The vPOS is initially shipped enabled to connect to a default gateway with a single instance of a 
gateway defined that accesses a predefined site for testing of an installation before bringing it 
online in a production mode. The test installation contacts and converses with an actual 
gateway that simulates live transactions. After the installation checks out utilizing a set of test 
transactions, the test gateway downloads the pre-checked customization to the installation so 
that it can switch over to the production acquirer. This download processing is enabled in 
extensions to SET. 

Internet Transaction Gateway 

Payment methods that issue cards for conducting business utilize four major entities. These 
entities are the issuer, consumer, merchant and the acquirer. The issuing bank that provides 
the consumer with a credit card are usually not the same bank as the acquiring bank that 
serves the merchant. When the consumer utilizes a credit card to pay for a purchase, the 
merchant swipes the card through the POS terminal which makes a connection to the 
merchant's acquirer via the telephone network and transmits an authorization request with 
data read from the magnetic stripe. The acquirer's host processor, depending on the card 
number, will either perform local processing or switch the request to the correct issuing bank's 
host processor through the interchange network. In a few seconds, the authorization response 
is returned to the originating POS indicating either an approval or a rejection. 

The internet is a viable infrastructure for electronic commerce. Ubiquitous browser software 
for the World Wide Web provides around-the-clock access to a large base of information content 
provided by Web servers. Utilizing a preferred embodiment, consumers using browsers can 
shop at virtual stores and malls presented as Web pages managed by the merchants' servers. 
Consumers can make purchases and pay for them using credit cards or other digital payment 
instruments in a secure manner. For such Internet-based payments to be authorized, a 
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"gateway" is necessary at the back end to channel transactions to legacy processors and 
interchange networks. 

Figure 21 is a detailed diagram of a multithreaded gateway engine in accordance with a 
5 preferred embodiment. Processing commences when a TCP transaction 2100 is received by a 
HTTPS Server 2102 and parsed to an appropriate Web Adaptor 2104 which posts an encrypted 
set transaction to the multithreaded gateway engine 2110. The encrypted SET request is 
received at a decryptor 2120, decrypted into a standard SET transaction and authenticated for 
converting by the forward converter 2124. Inside the forward converter 2124, decides if the 

1 0 request is an original request, and honest retry attempt or a replay attack. The converted 
transaction is passed to the socket multiplexor 2130 to communicate via an existing 
communication link 2140 to a host computer. A security logger 2150 is also utilized for 
passing security records back via a database server 2160 to a database administration 
application 2190. A transaction logger 2155 also utilizes the database server 2160 to capture 

1 5 transaction logs in a database 2180. Other system administration tasks 2195 include a web 
server administration task 2190 which logs web hits in a log 2170. 

Figure 22 is a flow diagram in accordance with a preferred embodiment. Processing flows from 
customers 2200 that are paying for products over the Internet or other communication 
20 medium utilizing HTTPS or other protocols to one or more merchants 2210, 2220 or 2230 to a 
gateway 2240 which directs transactions to a particular host processor 2250 for authorization 
processing in accordance with the present invention. 

Internet Payment Authorization 

The Gateway is a secure computer system that mediates transactions between the merchants' 
25 servers and a payment processor. The Gateway supports secure communications between 
merchants using the Internet on one side, and a processor using standard secure financial 
networks on the other side. Between the two interfaces, the Gateway maintains a detailed log 
of all transactions, whether in-progress, completed, or failed. The Gateway accepts 
transactions from merchants and converts them into legacy compatible formats before 
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forwarding them to the host processor. Responses from the host, after the reverse conversions, 
will be returned to the originating merchants. 
The Gateway performs many functions, including: 

• Receives encrypted credit card transactions from the merchants via the Internet 
5 • Unwraps and decrypts transactions 

• Authenticates digital signatures of transactions based on certificates 

• Supports all transaction types and card types 

• Accepts concurrent transactions from each of the merchant servers 

• Converts transaction data to legacy formats; forwards the mapped requests 
1 0 (in the clear) to a payment processor over existing communication links 

Converts transaction responses, correlates them with the original requests, and sends 
the mapped responses back to the merchants 

• Provides logging, monitoring, reporting, and system administration 

Figure 23 illustrates a Gateway's 2330 role in a network in accordance with a preferred 
15 embodiment. The Gateway 2330 strictly conforms to all SET stipulations regarding certificate 
management, PKCS signed data encapsulation, PKCS encrypted data encapsulation, ASN.l 
representation, DER encoding, MIME encapsulation, and message sequencing. A merchant 
server 2300 communicates via the Internet 2310 using the SET protocol 2320 through a 
gateway server 2330 using a network interface processor 2340 to communicate to a legacy 
20 network 2360 in, for example the X.25 protocol 2350. The legacy host 2370 ultimately 

receives and processes the transaction from the merchant server 2300 without modification to 
its code. 

Internet Communication Protocols 

As discussed above, the TCP/IP protocol suite is utilized at the transport level. At the 
25 application level, in compliance with SET, all requests arrive at the Gateway in MIME 

encapsulated HTTP format. Similarly, all responses from the Gateway to the merchant servers 
will be transferred in HTTP. The HTTP protocol stipulates that a request-response pair will go 
through the same TCP connection and that the originator, in this case a merchant server, will 
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establish a connection to send the request and will take down the connection when it has 
received the response. 

Host Payment Protocols 

Message conversions performed by. the Gateway will be significantly more than format 
5 transliterations: per- protocol differences in data elements and message semantics must be 
considered carefully. Some of the transaction types that are supported are listed below. 



Transaction Types 

Credit card sale with capture 
Credit card sale without capture 

Credit card sale with capture including AVS (MasterCard and VISA) 
Credit card sale without capture including AVS (MasterCard and VISA) 
Credit card return (Credit) 
Credit card post authorization (Force Post) 

Credit card post authorization (Force Post) with partial reversal support, 
enhanced authorization data, and AVS result code (VISA) 
Credit card sale with capture - Void 
Credit card return (Credit) - Void 
Totals request (for balancing) 



Host Communications Protocols 

10 A virtual, private network between the Gateway and the host processor is established to 

expedite host communication. In addition, two Network Interface Processors (NIP)s - a "near 
end" NIP that interfaces to the Gateway and a "far end" NIP that interfaces to the host. The 
NIPs will handle virtual connections between themselves. The far-end NIP will take care of 
specific communication details. The near-end NIP is an IP-addressable device that converts 

1 5 between TCP messages and packets. It is installed on a public network 2330, which is a LAN 
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outside the corporate firewall. The Gateway, on the secure public network 2330, utilizes 
TCP/IP 2320 to communicate with the near-end NIP. 

GATEWAY FEATURES 

Because the Gateway must sustain reliable operations and enable graceful evolution, it is 
5 designed with some important attributes, including: Security, Availability, Performance, 
Scalability, and Manageability. 

Security 

Channel Securitu 

At the application level, SET provides signed and encrypted data encapsulations of payment 
10 information portions of the transaction messages. Transport-level encryption of the entire 
message packet is required for additional security. The HTTPS protocol - i.e., HTTP over SSL 
3.0 - is utilized between the merchants and the Gateway. The virtual connections between the 
near-end NIP and the host are part of a private network. The termination will occur outside the 
firewall. Data between the Gateway and the host is sent in the clear with no encryption. In 
1 5 this network configuration, a transaction between a merchant's vPOS and the host will cross 
the firewall four times: SET request from vPOS to Gateway, legacy request from Gateway to 
NIP, LEGACY response from NIP back to Gateway, and SET response from Gateway back to 
vPOS. 

Certificate Management 

20 Payment Protocol Certificates 

The Gateway uses certificates to authenticate the two parties involved in each MOSET 
transaction. Through a Certificate Authority, one certificate is issued for the Gateway and one 
certificate for each of the merchant servers. 

Secure Channel Certificates 

25 SSL will require separate certificates for the Gateway and the merchants. 
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Availability 

Site redundancy and location redundancy allows the Gateway to sustain service through 
virtually instantaneous recovery from internal failures or external disasters that cause physical 
damages to the system. Minimum-outage recovery is possible with redundant configurations of 
5 important components. 

Site Redundancy 

The Gateway supports connections to a proprietary bank network and supports mirrored disk 
arrays. 

Location Redundancy 

10 The Gateway architecture supports location redundancy where a secondary remote system is 
connected to the primary system via dedicated WAN links for software -driven database 
duplication. 

Scalability 

The Gateway software architecture, the choice of third-party software components, and the 
1 5 selection of hardware platforms enable the system to gracefully adapt and evolve to take on new 
demands in different dimensions. 

The Gateway resides on an HP 9000 that is housed in a standard 19" E1A rack. 

Gateway Hardware Configuration " 



Server Hardware Description* 

K-Class SMP Server - Model K420 - Standard Configuration 

120 MHz PA-RISC 7200 CPU 
128 MB ECC RAM 

Built-in I/O includes Fast/ Wide /Differential SCSI-2, EtherTwist 802.3 LAN, 
AUI, RS-232C Connectors, Centronics Parallel Port, and Internal Modem 
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650 MB CD-ROM Drive 


HP-UX 10.10 Operating System (with two-user license) 


4 HP-PB Slots 


Additions 


1 


SCSI-2 Disk Controller 

to support disk mirroring over dual SCSI-2 buses 


1 


2 GB Internal SCSI-2 Disk Drive, 20MB/ s transfer rate, not mirrored 
for systems software and swap space 


1 


4 GB External High -Availability Disk Arrays 

for databases - total of 4x2 MB modules required 


1 


4 GB DAT drive with data compression 


1 


HP-PB Slot Expansion Option 

provides 4 additional HP-PB slots for peripheral controllers 


2 


FDDI interface cards (each card uses 2 HP-PB slots) 


1 


Option for eight-user license for HP-UX 



Cryptographic Hardware 

The encryption and decryption algorithms used in processing SET/ SSL messages require 
significant computational power. A "security processor* is deployed with the Gateway to boost 
5 the performance of cryptographic algorithms. The processor is a networked peripheral device t 
the HP 9000 server. It provides cryptographic services suitable for SET/ SSL processing, and 
its services are accessible via calls to software libraries running on HP-UX. Figure 24 is a 
block diagram of the Gateway in accordance with a preferred embodiment. 

Gateway Architecture 
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Operating System Software 

The Gateway runs under the HP-UX Version 10. 10 operating system and is upgraded to 
support future significant system releases. HP-UX 10. 10 conforms to major standards, 
including: 

5 • X/Open UNIX 95 (conforming with the Single UNIX Specification, SPEC 1 170) 

• X/Open Portability Guide Issue 4 Base Profile (XPG4) OSF AES 

• IEEE POSIX 1003.1 and 1003.2 

• AT&T System V Interface Definition (SVID3 base and kernel extensions subset) Level 1 API 
support 

10 • UC Berkeley Software Distribution 4.3 (BSD 4.3) including such features as job control, fast 
file system, symbolic links, long file names, and the C shell 

• System V.4 File System Directory Layout 

This compliance with various software standards assures that while a preferred embodiment of 
the invention is disclosed in association with a best mode of practicing the invention other 
15 similar software and hardware environments can be readily substituted without undue 
experimentation. 

Relational Database Management System (RDBMS) Software 

The Gateway uses Oracle7 Server version 7.3 as the RDMBS and will be upgraded to use future 
significant system releases. The multi- threaded, multi-server architecture of Oracle7 provides 
20 applications with scalability to high-volume transaction workloads. When deployed with the 
HP 9000 K-Class platform, Oracle7 performs a symmetrically parallel database operation 
across all available processors. In addition, Oracle7 includes options for creating high- 
availability systems: 

• The Oracle7 Parallel Server option extends the reliability of applications by transparently 
25 harnessing the power of clustered computers in a single logical processing complex that can 

tolerate individual machine failures. 

• Oracle7 Symmetric Replication provides high data availability. Data can be replicated from 
the primary system to one or more alternative sites. 
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HTTP Server 

The Gateway utilizes Netscape's Enterprise Server 2.0 as the HTTP server. The server is 
designed for large-scale Internet commerce deployment, Enterprise Server 2.0 achieves 
performance and reliability with such features as optimized caching, SMP support, enhanced 
memory management, and SNMP-based performance monitoring. Efficient process 
management features minimize system load and increase server reliability. Security features 
are provided using the SSL 3.0 protocol. 

Protocol Stacks 

Internet and LAN - The TCP/IP protocol stack will be provided as part of the HP-UX operating 
system. 

Other Application-Level Protocols 

Application-level protocols enable client-server interoperability. Each of the following protocols 
are transported using TCP or UDP. 

• HTML. HTML will be used to define screens for Gateway system administration. 

. HTTP. The HTTP layer is part of Enterprise Server 2.0. The server is administered with a 

Web browser. 

. SQL*Net. The Gateway's Oracle7 database can be accessed by administration clients using 
SQL'Net. Administration software can establish database connectivity to retrieve data for 
generating transaction reports. 

. SNMP. Enterprise Server 2.0 can be monitored using SNMP. The Gateway utilizes SNMP 
for remote system management. 

Transaction Performance Monito ring and Measurement 

. The "hits" performance indicators are available from the Web server. Statistics can be 
generated at any time to highlight the load pattern or to pinpoint the time when the server was 
most active. 
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• Gateway statistics about transaction requests (by transaction type} and transaction results 
(e.g., success, failed due to host, failed due to authentication, etc.) can be determined at any 
time for a particular time interval by generating a report. 

The Gateway is upgradeable to interoperate with a real-time event monitoring system such as 
5 OpenVision's Performance Manager. 

Basic Request/ Response Mappings 

The following table shows the basic request/ response mapping between the SET protocol and 
the LEGACY protocol. 



' SET 
Request / Response 
Pair 


LEGACY Request/Response 
Pair and Transaction Code 


AuthReq, AuthRes 


LEG/CTR (05) 


AuthRevReq, AuthRevRes 


LEG/CTR (99) 


CapReq, CapRes 


LEG/CTR (42 or 44) 


CapRevReq, CapRevRes 


LEG/CTR (41) 


CredReq, CredRes 


LEG/CTR (40) 


CredRevReq, CredRevRes 


LEG/CTR (90) 


j BalReq, BalRes 


CTA/CTL (48) 



10 

Detailed Message Field Mappings 

The following sections map the fields in LEGACY messages to fields in SET messages. The 
names of the SET fields are the names used in the SET ASN. 1 specification. The full scope of 
the SET fields is listed in order to remove any ambiguity (but does nox necessarily reflect actual 
1 5 naming conventions in source code). 

LEGACY - Authorization Request Record (LEG) 
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LEGACY - Authorization 
Request Record 


t 

Place in SET request to get LEGACY request data 

1 
i 

1 


(a) Host Processing 
Address 


hard-coded at Gateway to "VERT 


(b) Record Type 


hard-coded at Gateway to "LEG" 


(c) Control 


hard-coded at Gateway to "6" 


(d) Originating Merchant 
Number 


from Merchant Certificate in unwrapped SET request 


(e) Sequence Number 


generated at Gateway 


(f) Original Sequence 
Number 


generated at Gateway 


(g) Date and Time of 
Original Transaction 




05 - CC Authorization 
Request 


AuthReq - AuthReqDate 


40 • CC Capture Credit 


CredReq . CredDate 


41 - CC Capture Void 


CapRevReq . CapRevDate 


42 - CC Capture Post (non 
AVS) 


CapReq . CapDate 


44 - CC Capture Post (AVS) 


CapReq . CapDate 


76 - CC Authorization 
Reversal 


This transaction code will not be used. 


(h) Device ID - part 1 


hard-coded at Gateway to binary zeros. 


(i) Device ID - part 2 


The Terminal-id generated by Merchant System and 
delivered to the Gateway software as a result of 
decoding the SET request. 


(]) Transaction Code 




05 - CC Authorization 
Request 


AuthReq received 


40 - CC Capture Credit 


CredReq received 
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LEGACY * Authorization 
Request Record 


Place in SET request to get LEGACY request data 


41 - CC Capture Void 


CapRevReq received j 


42 - CC Capture Post (non 
AVS) 


CapReq received (if CapReq . RespData . AVSResult is 
blank) 


44 - CC Capture Post (AVS) 


CapReq received (if CapReq . RespData . AVSResult is 
non- blank) 


76 - CC Authorization 
Reversal 


This transaction code will not be used. 


(k) Alphabetic Card Issuer 
Code 


computed at Gateway from PAN 


05 - CC Authorization 
Request 


AuthReq . PI . PANData . PAN 


40 - CC Capture Credit 


CredReq . RespData . CapToken . TokenOpaque . PAN 


41 - CC Capture Void 


CapRevReq . RespData . CapToken . TokenOpaque . 
PAN j 


42 - CC Capture Post (non 
AVS) 


CapReq . RespData . CapToken . TokenOpaque . PAN 

! 


44 - CC Capture Post (AVS) 


CapReq . RespData . CapToken . TokenOpaque . PAN j 


76 - CC Authorization 
S Reversal 


This transaction code will not be used. : 


(1) Authorization Amount 


| 

i 


05 - CC Authorization 
Request 


AuthReq . AuthReqAmt 


40 - CC Capture Credit 


CredReq . CredReqAmt (could be different than j 

! 

CapToken) j 


41 - CC Capture Void 


CapRevReq . CapRevAmt 


42 - CC Capture Post (non 
AVS) 

i , — . — — — 


CapReq . CapReqAmt j 
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LEGACY - Authorization 
Request Record 


Place in SET request to get LEGACY request date j 

i 


44 - CC Capture Post (AVS) 


CapReq . CapReqAmt 


76 - CC Authorization 
Reversal 


This transaction code will not be used. , 


(m) Cash Back Amount 


hard-coded to "00000000" (EBCDIC) 


(n) Card or Driver's License 
Data 




05 - CC Authorization 
Request 

Account Number 
Expiry Date 


AuthReq . PI . PANData . PAN 

AuthReq . PI . PANData . CardExpirauon j 


40 - CC Capture Creait 
Account Number 
Expiry Date 


CredReq . RespData . CapToken . TokenOpaque . PI . 
PAN 

CredReq . RespData . CapToken . TokenOpaque . PI . 
CardExp 


4 2 - CC Capture Void 
Account Number 
Fvnirv Date 


CapRevReq . RespData . CapToken . TokenOpaque . PI . 
PAN 

CapRevReq . RespData . CapToken TokenOpaque. PI . 
CardExp 


42/44 - CC Capture Post 
(nonAVSorAVS) 

Account Number 
Expiry Date 


CapReq . RespData . CapToken TokenOpaque . PI . 
PAN 

CapReq . RespData . CapToken . TokenOpaque . PI . 
CardExp 


76 - CC Authorization 
Reversal 


This transaction code will not be used. 


(o) Additional Data 
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L*cAjtft\-> i * Auuionw mm 


place in SET request to get LEGACY request data 


P^aueiit Record 


r 

— — 


c/v) ♦ Cu Auirxortzcinori 






AuthReq . AVS Data . ZIPCode (if VISA Card) blank (if 


ZIP Code 


non VISA Card) 


40 • CC Capture Credit 




BANK Reference - 


CredReq . RespData . LogReilD 

j 


Number 


i 
i 

. . ! 


4 J - CC Capture Void 


j 


BANK Reference 


CapRevReq . RespData . LogReflD j 


Number 


! 


42 - CC Capture Post 




Authorization Code 


CapReq . RespData . AuthCode 


44 - CC Capture Post AVS 




(p) CPS ACI Flag 


CapReq . RespData . CapToken . TokenOpaque 


(q) CPS Transaction 


CPSAciFlag 


ID 


CapReq . RespData . CapToken . TokenOpaque . 


(r) CPS Validation 


CPSTransId 


Code 


CapReq . RespData . CapToken . TokenOpaque . 


(8) Visa Response 


CPSValCode 


Code 


CapReq . RespData . CapToken . TokenOpaque . \ 


(tt Merchant Category 


VisaRespCode 


Code 


CapReq . RespData . CapToken . TokenOpaque . 


(u) Entry Mode 


MerchantCatCode 


(v) Original 


CapReq . RespData . CapToken . TokenOpaque . 


Authorization Amount 


EntryMode 


(w) AVS Result Code 


CapReq . RespData . CapToken . AuthAmt 


(x) Authorization 


CapReq . RespData . AVSResult 


Code 


CapReq . RespData . AuthCode 


76 - CC Authorization 


This transaction code will not be used. 


£ei/ersa/ 
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LEGACY - Authorization Request Response (CTR) 



The field Settlement Date is returned by the host in a LEGACY Authorization Request 
Response (when a transaction is force posted). 

This Settlement Date field contains the day that a posted transaction will be settled between 
the Merchant and the Acquiring Bank. Since a bank desires that this date be made available to 
the Merchant for the purposes of financial record keeping this field must be returned to vPOS. 



LEGACY - Authorisation 
Request Response 


Place in SET response to put LEGACY data 
returned from host 

i 


(a) Host Processing Address 


echoed by host, not included in SET response 


(b) Record Type 


echoed by host, not included in SET response 


(c) Control 


echoed by host, not included in SET response 


(d) Settlement Date 


echoed by host 


(e) Sequence Number 


echoed by host, not included in SET response 


|f) Original Sequence Number 


echoed by host, not included in SET response 


(g) Account Indicator 


not included in SET response 


i (h) Device ID - part 1 


echoed by host, not included in SET response 


"j (i) Device ID - part 2 


echoed by host, included in SET response in a 
location to be determined by the Payment Protocols 
Team. The value echoed is the terminal-id as 
delivered in the SET request. 


(j) Action Code 


The Action code returned in the LEGACY response 
will be combined with the Error Code (if present) and s 
translated to a canonical list of error codes. See 
section 0 for exactly where this canonical error code 
will be returned for each transaction type. 


(k) Transaction Code 


echoed by host, not included in SET response 
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LEGACY - Authorization 
Request Response 


Place in SET response to put LEGACY data 
returned from host 


(1) Authorization Amount 


05 • CC Authorization Request 


AuthResPayload . AuthAmt (if Salesind * False) 
SaleRcsPayload . CapAmt (if Salesind = True) 


40 - CC Capture Credit 


f**rt*f\ A ft'i i q 1 Am t 
\^ rCU/lC L UcU/Vl LI L 


41 • CC Capture Void 

< 


CaptureArat 


42 - CC Capture Post (rton 
AVS) 


CapRes . CapRevSeq . CapResItem . 
CapResultPayload . CapAmt 


44 - CC Capture Post (AVS) 


CapRes . CapRevSeq . CapResItem . 
CapResultPayload . CapAmt 


76 - CC Authorization 
Reversal 


This transaction code will not be used. 


(m) Authorization Code 




05 - CC Authorization Request 

j 


AuthResorSale . RespData . AuthCode (if 
SalesInd=False) 

AuthResorSale . RespData . AuthCode (if 
SalesInd«True) 


(n) AVS Result Code 


AuthResorSale . RespData . AVSResult 


(o) Reference Number 


AuthResorSale . RespData . LOGRefld 


AVS Result Data 

only received if transcode = 
05 and VISA and 

approved but not captured 




(p) CPS ACI Flag 


AuthResorSale . RespData . CapToken . 
TokenOpaque . CPSAciFlag 


(q) CPS Transaction Id 


AuthResorSale . RespData . CapToken . 
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LEGACY - Authorisation 
Request Response 


• 

Place in SET response to put LEGACY data 
returned from host 


i TokenOpaque . CPSTransId 


(r) CPS Validation Code 


AuthResorSale . RespData . CapToken . 
TokenOpaque . CPSValCode 


(s) Visa Response Code 


AuthResorSale . RespData . CapToken . . 
TokenOpaque . VisaRespCode 


|t) Merchant Category Code 


AuthResorSale . RespData . CapToken . 
TokenOpaque . MerchantCatCode 


1 (u) Entry Mode 

1 
i 


AuthResorSale . RespData . CapToken . 
TokenOpaque . EntryMode 



WO 98/05011 



- 156- 



PCT/US97/13673 



Error Code Location in SET response messages 

The following table shows the explicit SET field in which the canonical error code will be 
returned in SET response messages. 

5 



SET Response 
Message 


Location of Canonical Error Code 


AuthRes 


AuthResorSale . RespData . RespCode (if 

Salesind = False) 
AuthResorSale . RespData . RespCode (if 

Salesind = True) 


AuthRevRes 


AuthRev will not be supported by the Gateway 


Cap Res 


CapRes . CapResSeq . CapResltem . CapCode 


CapRevRes 


CapRevRes . CapRevResSeq . 
DraftCaptureStatus 


CredRes 


CredRes . CredResSeq . CredResItem . 
CredCode 


i CredRevRes 


CredRev will not be supported by the Gateway 


BalRes 


CapRes . CapResSeq . CapResltem . CapCode 



Error Code Values in SET response messages 

The following table itemizes the proposed mapping of LEGACY specific action codes and error 
code pairs to the canonical error codes that will be sent in the SET response messages. 
The canonical error response code values and descriptions were taken directly from "ISO 8583 : 
10 1987 section 4.3.8 Table V . 
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VeriFone Proprietary SET Extensions 

The SET protocol currently has no provisions to support 'Balance Inquiry" requests. Balance 
Inquiry requests are used by the Merchant to query its Acquiring Bank as to various totals for 
the current days or past days transaction totals. 

The following two sections detail a proposed mapping between the LEGACY protocol and two 
new VeriFone proprietary SET extensions: BaUnq (Balance Inquiry) and BalRes (Balance 
Response). The BaUnq request is used by vPOS to query the Gateway as to the transaction 
totals and BalRes is the response sent by the Gateway to vPOS. 



LEGACY - Administrative Inquiry Record (CTA) 



LEGACY - Administrative Inquiry 
Record 


Place in SET request to get LEGACY request 
data 


(a) Host Processing Address 


name-value pair 


(b) Record Type 


name-value pair 


| (c) Control 


name -value pair 


(d) Merchant Number 


name-value pair 


(c) Device ID - part 1 


name-value pair 


(1) Device ID - part 2 


name-value pair 


(g) Date and Time of Inquiry 


name-value pair 

_ ■ — ■ ■■ 


(h) Sequence Number 


name-value pair 


(i) Transaction Code 


i name-value pair 


(j) Feedback Level 

10 - Totals online and offline for the 
Merchant 
20 - Totals online and offline for the 
| Chain 


j name-value pair 
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LEGACY - Administrative Inquiry 


; 

Place in SET request to get LEGACY request 


Record 


data 


(k) Feedback Day 


name-value pair 


0 - Today 




1 - Yesterday 




2 - Two Days Back 




3 - Three Days Back 




(1) Feedback Type 


name-value pair 



00 - All combined Visa and 

t 

I MasterCard Sales 

10 - MasterCard Net Totals 
20 - Visa Net Totals 
40 - Discover Totals 
50 - Amex Totals 
(m) Feedback ID ; name-value pair 

Level 10: 7 Digit Merchant 
Level 20: 5 Digit Chain 



LEGACY - Administrative Response Record (CTL) 



LEGACY - Administrative Response 


Place in SET response to put LEGACY data 


Record 


returned from host 


(a) Host Processing Address 


name-value pair ] 


(b) Record Type 


name-value pair ^ j 


(c) Control 


j name -value pair ✓ 


(dj Settlement Date 


i name-value pair 

J , — 
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LEGACY - Administrative Response 
Record 


Place in SET response to put LEGACY data 
returned from host 


(e) Sequence Number 


name-value pair 1 


(f) Device ID - part 1 


name-value pair 


(g) Device ID - part 2 


name-value pair 


(h) Action Code (0,D or E) 


name-value pair j 

. — i 


(i) Transaction Code 


name-value pair 


Additional Data 

(j) Error Code 

(k) Total Item Count 

(1) Total Sales Amount (Credit Card) 

(m) Totals Sales Item Count 

(n) Total Credits Amount (Credit Card) 

(o) Total Credits Item Count (Credit Card) 


name-value pair ; 

■ 
• 

i 



Gateway Analysis for SET Message Handling 

This section tackles general design considerations of the Gateway software and is not limited to 
LEGACY (unless specifically mentioned). The complete functional behavior of the Gateway will 
5 be described in a separate document. 

Replay Attack Handling 

A replay attack at the Gateway is a request where either: 

a) the request is stale, the request was received "too late" with respect to the reqdate 
in the request. This window is specified by a configurable Gateway policy. 
1 o b) the request is not stale but the exact rrpid (Request/ Response Pair Id) has already 

been seen before in a request and still logged in the Gateway database. The <xid, 
mid, rrpid> tuple will be the primary key that determine whether a request had 
already been received. This will allow the possibility of the same rrpid to be 
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generated from the same merchant but for a xid and also allow the same rrpid to 
be generated by a totally different merchant. 

New Attempt vs. Retry Attempt 

It is possible that messages sent between the vPOS and Gateway may be lost in transit. This 
5 could happen either because of hardware/ software problems in the Internet or for 
hardware /software reasons local to the Gateway or Merchant System. 
The question is then "How does a Gateway recognize an honest retry attempt from an 
initiator?" First a little background into the nature of a SET request. All SET requests have 
the following fields: 
10 xid merchant's transaction id 

mid merchant id (contained in certificate) 

tid terminal id (from Merchant System) 

rrpid request response pair id 

reqdate request date (From Merchant System) 
15 reqdata request specific data 



Let the following tuple represent a generic SET request: 

<xid, mid, tid, rrpid, reqdate, reqdata> 



20 The merchant establishes the xid during the shopping phase with the consumer. The same 
xid is used for both the AuthReq and the CapReq and subsequent CreditReq requests. Using 
the same xid for many requests makes it impossible for the Gateway to distinguish between 
repeated transactions vs. new transactions. 

25 For example, how could a Gateway possibly determine whether two valid CredReq requests 
were to be interpreted as two individual credits or a retry of a single request. 

request 1: <xidi, midm, tidt, rrpidi, reqdate i, reqdatai> (perhaps a CredReq for $10.00) 
request 2: <xidi, midm, tidt, rrpida t reqdatei, reqdatai> (perhaps a new CredReq for $10.00) 

30 

could also be interpreted as... 
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request 1: <xidi, midm, tidt f rrpidi, reqdatei, reqdatai> (perhaps a CredReq for $10.00) 
request 2: <xidi, midm, tidt, rrpidi, reqdatei, reqdatai> (perhaps a retry of above) 

5 The reqdates are different in both cases because the date is generated along with the rrpid to 
thwart replay attacks. In this example the Gateway will not be able to determine whether the 
second CreditReq should be performed or whether it is simply a retry to request 1 with rrpidi. 
The Gateway must know whether or not to apply a new credit or to deliver a response that it 
may already have from the host (it may have came too late for the first attempt or have been 
10 lost on the way to vPOS). If no response was logged from the host for request 1, the Gateway 
could repeat its original request to the host when receiving request 2. In a sense, the Gateway 
will act as an intelligent request /response cache. 

The Gateway splits the rrpid number space into two parts. One main part that will remain the 
1 5 same for the same request across all its retry attempts and a smaller portion to indicate the 
number of retry attempts. Then, 

rrpidRetryCount s rrpid MOD MAXRETRIES (0 for initial request, >0 for a retry) 

20 NOTE : The initial rrpids generated by vPOS software are equal to 0 MOD MAXRETRIES and 
in subsequent retries the lower order digits are incremented by one for each retry attempt. 
This requires extra stored in the vPOS application. The vPOS software must persistently store 
the rrpid used (which contains the retry count of the transaction) so that repeated attempts 
will follow the correct semantics. 

25 

In general the Gateway will support the following logic [assuming the second request is fresh 
and not a replay attack): 
If two requests, 

request 1 :<xidi, midm, tidt, rrpidi, reqdatei, reqdatai> 
30 request 2 : <xidi f midm, tidt, rrpidi, reqdatei, reqdatai> 

are received at ti and t? (where t2>ti) and, 

[rrpidi - (rrpidi MOD MAXRETRIES)) a (rrpidi - (rrpidi MOD MAXRETRIES)) 
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then the Gateway will interpret the second request as a retry request. 
But if, 

(rrptdi - [rrpidi MOD 100)) * {rrpida - (rrpfcfc MOD MAXRETRIES)) 
then the Gateway will interpret the second request as a new request. 

5 

In addition to being able to distinguish between a retry and a new request, the proposed rrpid 
scheme can be used to determine how many vPOS requests got lost in the Internet. This is a 
useful value-added service for system management. 

Robustness and Error Handling Issues 

10 There are several robustness issues that need to addressed. The basic flow is that vPOS sends 
a request to the Gateway, the Gateway logs the SET key fields from the incoming attempt in the 
database. The Gateway then generates a host request which it logs completely in the database. 
The host handles the request and generates a response that is directed towards the Gateway 
which, when received is logged completely in the Gateway database. Finally the Gateway 

15 generates an SET response to vPOS, the contents of which is not logged in the database. 

If the Gateway has not received the request or receives the request but is not able to log the 
request in the database it is easily handled by a vPOS retry attempt. This recovery action 
needs no further discussion. In general, if the vPOS does not receive a reply to a request it has 
20 sent to the Gateway it must retry persistently until a response is received. All retry attempts 
from vPOS for the same request must have the same base portion of the rrpid but a different 
value in the retry counter . 

The Gateway must handle replay attacks as outlined previously in this document. 
25 If the Gateway receives a request that it has already received from vPOS there could be several 
possible dispositions: 

a) the request had already been handled completely with the host and a host response 
is in the Gateway database. In this case the Gateway can simply translate the host . 
response to a SET response and send it to vPOS. 
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b) the request had been sent to the host before (as determined by a database field) but 
a response from the host is not on file. In this case the Gateway must retry the host 
request. 

5 If the vPOS times-out for any reason, it must retry later using an rrpid that indicates a retry 
attempt. If the Gateway receives a late-response (after vPOS has given up) it simply logs it in 
the database for that retry attempt (if no retry attempt for the transaction is still outstanding at 
the host). There is a glare situation where the original response could arrive so late that it 
could be confused with the response from a currently outstanding retry attempt with the host. 
10 This situation is logged and the first response not sent back to vPOS. 

A response from the host indicating a successful transaction may get lost on the way back to 
the Gateway or not be able to be logged in persistent storage in the Gateway. In either case 
vPOS is in a situation where the retry request when received by the host may result in a 
1 5 response from the host indicating that the request is a duplicate. The vPOS software must be 
able to handle this. In the LEGACY case when a duplicate post is received by the host the 
second one automatically causes the first one to void and the second transaction fails too. In 
this case vPOS should retry the transaction under a new rrpid. If the transaction goes 
through end-to-end all effects of the previous transactions will not matter. 

20 

TokenOpaque Contents 

The Gateway requires information captured at the time of an AuthReq that must be repeated to 
the host at the time of the associated CapReq. The mechanism of choice (built into SET) for 
this is enabled utilizing this data in the TokenOpaque token of the CapToken which is sent in 
25 an AuthRes. This CapToken is stored at the Merchant system and represented to the Gateway 
at the time of the CapReq. The format of an TokenOpaque is an OctetString. 
The following general format (not specific to LEGACY) is proposed for capturing this 
information: 



Field Name Field Data Type 

VersionName char(8) 



Explanation/Example 

e.g. -LEGACY" 
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VersionRevision 

PILength 

PI 

HostSpecDataLengt 
h 

HostSpecData - 



char{8) 
integer 

unsigned char(PI Length) 
integer 

unsigned 

char(HostSpecDataLength) 



e.g. "1.0* (generally <major, minor>) 
length of PI data 
strongly encrypted 
length of host specific data 

host specific data 



Host Specific Data (LEGACY -only) 

For "LEGACY" version "1.0", it is proposed that newline seperated "name(length]=value" pairs 
5 be used to store the host specific data. A null character will terminate the host specific data. 
The following host specific data (name value pairs) will need to be included: 



BrandID 
CPSACIFlag 
10 CPSTransactionld 
CPSValidationCode 
VisaResponseCode 
MerchantCategoryCode 
EntryMode 

15 

NOTE: PI contains PAN and ExpiryDate. 



Proposal for AVS Data Encoding 

The "Address Verification" data element for the "Address Verification Service" (AVS) is defined in 
20 SET as an IASString. Each host may require different data 10 be sent to use the AVS feature. 
The Gateway will need to be able to extract the information from this to inter-work with the 
legacy systems. A well-defined format for this data is required, an IASString blob is insufficient. 

The following data structure is utilized to deliver the AVS data.\ 
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StreetAddrcss 1=800 El Camino Real\n 
StreetAddress2=Suite 400 \n 
City=Menlo Park\n 
5 StateProvince*CA\n 
Country=USA\n 
PostOfficeBox*\n 
ZipPostaJCode=94025 \ n 
\n 

10 

An empty line indicates the end of AVSData. 

The detailed information that is available for the Address Verification Service depends on the 
Payment Window that captures the data from the consumer. 

15 AVS Data (LEGACY-onlvl 

For "LEGACY" version "1.0" only the ZipPostalCode name value pair is required. The Gateway 
will only use the first 5 characters of this value. 

Transaction Replay Attacks 

20 The processing of Internet- based payment transactions is a coordinated interaction between the 
Internet Transaction Gateway and the vPOS servers that is based on the following principles. A 
vPOS terminal, as the initiator of the payment transaction, is responsible for the round-trip 
logical closure of the transaction. vPOS will retry a transaction that has been initiated with the 
Gateway but where the response for the request was never received from the Gateway. A vPOS 

25 terminal selects - out of a pre-assigned range - aTerminal-Id that is to be used by the 

Gateway in a request to the host processor. This data element must be transported from the 
vPOS to the Gateway along with the payment-related information. The Terminal-Ids must be 
unique among the concurrent vPOS instances on a vPOS server system. However, the 
Terminal-Ids have no history For example, a subsequent Force Post transaction need not use 

30 the same Terminal-Id as the original Authorization transaction. The vPOS will be responsible 
for making sure that only one request is outstanding for the same <Merehant-id 9 Terminal- 
id> data elements from a vPOS server system. The Gateway does not know that a response 
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was successfully received by vPOS. This means that the vPOS must be responsible for 
initiating any retry attempts. The Gateway never initiates a retry attempt with the host 
processor without an explicit retry request from vPOS. The Gateway when asked to retry a 
request with the host, performs a relational database look-up and delivers a response that has 
already been received from the host processor but was previously missed by vPOS. This 
behavior of the Gateway is also known as the -transaction response cache." The Gateway will 
need to know that a vPOS request is a retry of something already sent. The prior request may 
or may not have been received. A solution for determining the difference between a retry 
attempt and a new request was described earlier in this document. vPOS must understand the 
"canonical" error codes that it will receive via the Gateway and be able to initiate the proper 
recovery action and/or generate the appropriate user-interface dialog. 



Certificate Processing 

Merchants require a mechanism for verifying legitimate cardholders is of valid, branded 
bankcard account numbers. A preferred embodiment utilizes technology to link a cardholder to 
a specific bankcard account number and reduce the incidence of fraud and thereby the overall 
cost of payment processing. Processing includes a mechanism that allows cardholder 
confirmation that a merchant has a relationship with a financial institution allowing it to 
accept bankcard payments. Cardholders must also be provided with a way to identify 
merchants they can securely conduct electronic commerce. Merchant authentication is 
ensured by the use of digital signatures and merchant certificates. 

In a preferred embodiment, a holder of a payment instrument (cardholder) surfs the web 
(Internet) for required items. This is typically accomplished by using a browser to view on-line 
catalog information on the merchant's World Wide Web page. However, order numbers can be 
selected from paper catalogs or a CD-ROM and entered manually into the system. This method 
allows a cardholder to select the items to be purchased either automatically or manually. 
Then, the cardholder is presented with an order form containing the list of items, their prices, 
and totals. The totals could include shipping, handling and taxes for example. The order form 
is delivered electronically from the merchant's server or created on the cardholder's computer 
by electronic shopping software. An alternative embodiment supports a negotiation for goods 
by presenting frequent shopper identification and information about a competitor's prices. 
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Once the price of goods sold and the means of payment has been selected, the merchant 
submits a completed order and the means for payment. The order and payment instructions 
are digitally signed by cardholders who possess certificates. The merchant then requests 
payment authorization from the cardholder's financial institution. Then, the merchant sends 
confirmation of the order, and eventually ships the goods or performs the requested services 
from the order. The merchant also requests payment from the cardholder's financial 
institution. 

Figure 1C is a block diagram of a payment processing system in accordance with a preferred 
embodiment. The Certificate Issuance at the Bank Web Site 162 resides at the bank web site 
182. It is utilized for issuing SET complaint / X.500 certificates to consumers. The 
implementation of this system may vary from one bank to another. However, the system 
gathers consumer's personal information, and after processing the information, the system 
issues a certificate along with a payment instrument to the consumer. 

The Single Account Wallet 160 at the bank web site 182 represents the MIME message that is 
created by the Certificate Issuance system. This MIME message contains a VeriFone wallet. The 
VeriFone wallet contains a single payment instrument and the certificate associated with it. For 
security reasons, the private key is not included in the wallet. The has to specify a private key 
before using the instrument for payment. When the consumer is issued the certificate, this 
MIME message is sent to the browser. The browser launches the Certificate Installation 
application 174, 144 which is defined as a helper application in the browser. The Certificate 
Installation application 174, 144 reads the MIME message and install the wallet into the wallet 
database 158. 

Various helper applications 198, 172, 174, 176 are provided to make the consumer's shopping 
experience easy and efficient including the following helper applications. The Paywindow helper 
application 188 is utilized by the consumer to authorize the payment to the merchant, to 
administer their wallets, to review their previously completed payment transactions and to 
perform housekeeping activities on the wallets. This application is defined as a 'helper' 
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application on the consumer's desktop. The browser launches this application when the 
merchant system sends a MIME message requesting payment. 

The PayWindow Setup Helper application 172 is used by the consumer to install helper 
5 applications and other modules from the web site onto the consumer desktop. When a 
consumer attempts to install an application for a first time, the consumer does not have a 
helper application on the desktop. Thus, the first time installation of an application requires a 
consumer to perform two steps. First the user must download the system package to their 
desktop and then the user must run setup to decompress and install the system. Thereafter, 
10 whenever the consumer gets a new release of system software, the browser launches this 
helper application which in turn installs the appropriate other system modules. 

The Certificate Installation Helper Application 174 is utilized to install a wallet that is issued by 
a bank. When the bank's certificate issuance web system sends the MIME message containing 
15 the VeriFone wallet, the browser launches this application. This application queries a consumer 
to determine if the payment instrument contained in the wallet is to be copied to an existing 
wallet or to be kept in the new wallet. This application then installs the payment instrument 
and the certificate into the wallet database 158. 

20 The Certificate Issuance CGI scripts 162 and the Single Account Wallet 160 at the Bank Web 
Site 182 is processed as described in the native system. The Certificate Installation Applet of 
the Bank Web Site 182 is utilized by the Certificate Issuance CGI scripts 162 system to deliver 
a consumer's certificate to the consumer's desktop. 

25 Figure 26 is an architecture block diagram in accordance with a preferred embodiment of the 
subject invention. Processing commences at function block 2600 where the Graphical User 
Interface (GUI) part of the application is initialized. The GUI application 2600 provides the 
consumer with support for ordering and making payments during the shopping process. There 
are also GUI components provided for wallet creation; importing, certificate and payment 

30 method creation and maintenance; and for transaction register review and reporting. The 
screen designs, and their associated logic, for the helper applications and applets are 
individually discussed in detail below. 
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The Certificate Manager 2604 manages the automatic downloading of a consumers certificate 
from a bank, validation of a consumer's and a merchant's certificates and automatic requisition 
of certificate renewal. 

5 

The Payment Manager 2606 coordinates and completes the payment request that is received 
from the merchant system. The payment request is received via a MIME message in the native 
code implementation or via an applet in the Java implementation. The payment request 
received contains the final GSO, Ship-To name, merchant certificate, merchant URL, coupons 
10 and the payment amount. The manager 2606 then communicates with the payment related 
GUI component to interact with the consumer to authorize and complete the payment 
transaction. The manager is also responsible for determining the payment protocol based on 
the consumer's payment instrument and the merchant's preferred payment protocol. 

1 5 The manager 2606 includes a well defined Application Programming Interface (API) which 

enables OEMs to interface with the payment manager 2606 to make payments to specific HTTP 
sites. The detailed logic associated with the payment manager 2606 is presented in Figure 27. 

The payment manager 2606 enforces standard operations in the payment process. For 
20 example the receipt and the transaction record can automatically be transferred to the Wallet 
file once the payment is completed. The payment manager architecture in accordance with a 
preferred embodiment is presented in Figure 27. A user interfaces with the payment manager 
2730 via a user interface 2700 that responds to and sends a variety of transactions 2710, 
2708, 2706, 2704 and 2702. The transactions include obtaining the next record, payment 
25 record, receipt, acceptance of the payment instrument and GSO components. In turn, the 
payment manager 2730 sends transactions 2714 and receipts 2720 to the wallet manager 
2722 and receives payment instruments, certificates and private keys from the wallet manager 
2722. 

30 The payment manager 2730 also sends and receives transactions to the protocol manager 
2770 including a merchant's payment message 2760, a consumer certificate and PK handle 
2750, a merchant URL 2742, a payment 2740, a signed receipt 2734 and a GSO, Selected 
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Payment Protocol and Selected Payment Instrument 2732. The payment manager 2730 also 
accepts input from the payment applet or MIME message from the merchant as shown at 
function block 2780. One aspect of the payment processing is a Consumer Payments Class 
Library (CPCL) 2770 which encapsulates the payment protocols into a single API. By 
encapsulating the payment protocols, applications are insulated from protocol variations. A 
SET Protocol provides an implementation of the client-side component of the Secure Electronic 
Transaction (SET) Protocol. A complete implementation of the client-side component of the 
CyberCash micro-payment protocol is also provided. 

The Wallet Manager 2722 provides a standard interface to the wallet. It defines the wallet 
database structures and the payment instrument data structures, controls the access to the 
wallet and provides concurrency checking if more than one application attempts to open the 
same wallet. The interface to the wallet manager 2722 is published to allow OEMs to interface 
with the wallet manager and access the wallet database. 
The wallet manager consists of the following sub-components: 

Wallet Access. This component provides an interface to read and write wallet information. 
Transaction Manager. This component provides an interface to read and write transaction 
corresponding to a wallet into the wallet database. 

Payment Instrument Manager. This component manager provides a common interface to the 
specific payment instrument access components. 

Credit Card Access, Debit Card Access, Check Access. These components deal with a specific 
payment instrument. 

A Data Manager provides storage and retrieval of generic data items and database records. It is 
assumed that data fields, index fields or entire data records can be marked as encrypted and 
the encryption process is largely automated. The data manager has no specific knowledge of 
database records appropriate to different payment methods. This layer is separated out so as 
to reduce changes required when new payment methods are introduced. However RSA key 
pairs and certificates might be considered as "simple'' data types. This component also 
provides an abstraction which supports wallet files on computer disk or contained in smart 
cards. 
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The Open Data Base Connectivity (ODBC)/ Java Data Base Connectivity (JDBC) component 
provides Data Base Connectivity where formal database components are required. An 
embodiment of the Smart Card Wallet allows wallet data to be stored and/or secured by a 
cryptographic token. 

5 

A preferred embodiment includes a single file or directory of files comprising a "wallet" which 
contains personal information and information about multiple payment methods with the 
preferred implementation. These payment methods ( Visa cards, debit cards, smart cards, 
micro-payments etc. ) also contain information such as account numbers, certificates, key 

10 pairs, expiration dates etc. The wallet is envisaged to also contain all the receipts and 

transaction records pertaining to every payment made using the wallet. A Cryptographic API 
component provides a standard interface for RSA and related cryptographic software or 
hardware. This support includes encryption, signature, and key generation. Choice of key 
exchange algorithm, symmetric encryption algorithm, and signature algorithm should all be 

15 configurable. A base class stipulates generic behavior, derived classes handle various semantic 
options (e.g. software based cryptography versus hardware based cryptography.) 

The Cryptographic Software portion provides RSA and DES support. This may be provided 
utilizing the SUN, RSA or Microsoft system components depending on the implementation 

20 selected for a particular customer. Cryptographic Hardware creates a lower level API which can 
underpin the Cryptography API and be utilized to replace Cryptography Software with an off the 
shelf cryptography engine. The message sequence charts describe the flow of messages/data 
between the consumer, the browser and/or the various major components of the Serneru 
system. The major components of the system are the Merchant system which includes the 

25 vPOS, the PayWindow, and the Payment Gateway. The merchant system allows a consumer to 
shop, accept the payment transactions sent by the PayWindow application, and send payment 
transactions to the acquiring bank. The Consumer Payments Class Library (CPCL) module is a 
layer within the application which sends the payment transactions, securely, from the 
consumer to the merchant. 

30 

Figure 28 is a Consumer Payment Message Sequence Diagram in accordance with a preferred 
embodiment of the invention. The diagram presents the flow of messages between the 
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consumer, the browser, the merchant system, the PayWindow application, and CPCL. This 
message flow describes the payment process from the time an order is completed and the 
consumer elects to pay, to the time the payment is approved and the receipt is returned to the 
consumer. The difference between the Native implementation and Java implementation of the 
5 PayWindow application is in the delivery of the order information to the PayWindow. Once the 
order information is received by the PayWindow, the flow of messages/data is the same for 
both implementations. In the case of the Native implementation, the order information is 
delivered via a MIME message. This MIME message is sent to the PayWindow by the browser 
via a document file. In the Java implementation, the order information is delivered to the 
10 PayWindow by an applet. The merchant system sends an applet with the order information to 
the browser which in turn delivers the order to the PayWindow. Once the order is received, the 
PayWindow interacts with the consumer and the Protocol modules for the completion of the 
payment process. 

15 Enters Order and Clicks Calculate Order 2820 

This message represent the consumer order entry and the clicking of the 'Calculate Order' 
button. The consumer's shopping experience is all condensed into this one message flow for 
the purpose of highlighting the payment process. The actual implementation of the shopping 
process varies, however, the purpose does not, which is the creation of the order. 

20 Order 2830 

This message represents the order information which is sent by the browser to the merchant 
via an HTML form. 

Payment Applet with GSO. PPPs, Ms. merchant certificate and URL 2840 
25 On receipt of the order, the merchant system calculates the payment amount. This message 

represents the HTML page which is sent by the merchant system detailing the payment amount 
along with the Java payment applet which contains the GSO ? PPPs, Ais, merchant certificate 
and URL. 

30 Run Payment Applet 2845 

The Java enabled browser runs the Payment applet. The applet displays a button called "Pay" 
for the consumer to click. This is embedded in the HTML page delivered by the merchant. 
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Clicks Pav 2850 

This message represents the clicking of the Pay button on the browser by the consumer 
confirming the payment amount. 

GSO. PPPs. AIs. merchant certific ate and URL 2860 

This message represents the GSO, PPPs, AIs, merchant certificate and the merchant UR 
carried by the Java applet. The Java applet now delivers these to the PayWindow applic 

Merchant certificate 2862 

This message represents the merchant's certificate which is sent to the CPCL module foi 
checking the validity of the merchant. 



Merchant's validity 2864 

The CPCL modules examines the merchant's certificate and send this message to the 
PayWindow indicating whether or not the merchant is a valid merchant. 

Wallet. Payment Instruments 2866 

This message represents the wallets and payment instruments that is displayed to the 
consumer. Not all payment instruments from a wallet is shown to the consumer. Only the ones 
accepted by the merchant is shown. 

Payment Instrument 2868 

This message represents the payment instrument selected by the consumer. This message is 
created in the current design when the user double clicks on the payment image in the "Select 
Payment Method" Window. 

GSO 2870 

This indicates that the GSO is displayed to the consumer in the -Make Payment Authorization" 
screen. 



Authorization of Payment 2872 
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This message represents the authorization of the payment by the consumer. The consumer 
authorizes the payment by clicking the 'Accept' button on the "Payment Authorization" screen 

Decide Payment Protocol 2874 

Once the consumer authorizes the payment, the payment protocol is decided by PayWindow 
based on the merchant's Payment Protocol Preferences and the consumer selected payment 
instrument. 



Payment Authorization 2875 

These messages represent the merchant's URL, the GSO, payment protocol (PP) to use, account 
number, certificate and the private key handle (PK) associated with the payment instrument 
which is sent to the protocol module. 

GSO with Payment Authorization 2876 

This message represents the payment instructions which is sent by the protocol module to the 
Merchant system. The GSO, PI, consumer certificate and PK is packaged based on the payment 
protocol. 

Signed Receipt 2878 

This message represents the digitally signed transaction receipt received by the protocol module 
from the merchant. 



Save Receipt with hash value 2880 

The digitally signed transaction receipt is saved by the PayWindow for future reference. 
Payment Successful 2882 

This indicates that the transaction receipt and the 'payment successful' have been displayed to 
the consumer. 

Certificate Processing 

A payment instrument must be certified by a "certificate issuing authority" before it can be 
used on a computer network. In the case of credit card payments, the issuer may be one of th< 
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card issuing banks, but it might also be a merchant (eg SEARS), a transaction aquiring bank or 
an association such as VISA or Mastercard. 

Payment instrument information is stored in the consumer's wallet. The certificate which 
5 authorizes the payment instrument will be stored along with that data in a secured database. 
The process of acquiring a certificate is described below. A certificate can be delivered to a 
consumer in a preconfigured wallet. The consumer receives a wallet which contains the 
certificate together with the necessary details associated with a payment instrument including 
a payment instrument bitmap which is authorized by a certificate issuing authority or the 
10 agencies represented by the issuing authority. 

Obtaining a certificate 

A consumer will deliver or cause to be delivered information to a certificate issuing authority. 

1 5 Figure 29 is an illustration of a certificate issuance form in accordance with a preferred 

embodiment. A user may fill out the form on-line, on paper and mail it in, or get his bank or 
credit card company to deliver it. The consumer delivered data will usually contain a public 
key belonging to a security key pair generated by consumer software. This information will 
normally be mailed to the consumer's address and actuated by a telephone call from the 

20 consumer. The certificate authority takes this information and uses it to validate that he is 

indeed entitled to use the payment method. This processing normally takes a few days to 

accomplish. Information will normally be exchanged with the organization issuing the payment 

* 

method in the physical space if there is one, and with credit agencies. The certificate 
information is loaded into the consumer's software to enable payment processing to proceed 
25 online. 

In some cases the consumer will be able to select details about a payment instument holder 
(wallet) he desires to own. This may be the icon representing a holder, the access password or 
other information. After creating the certificate, the issuing authority can use information 
30 received in the certificate application to create a custom payment instrument holder ready to 
use. This payment instrument holder will contain the following information. Payment 
instrument information including card number 2900 and expiration date 2902. Personal 
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information including name 2904, address 2906, social security number 2908 and date of 
birth 2910. 

The associated certificate ( eg X509 standard ), an associated public key or in some cases 
public/ private key pair ( eg RSA), and an approved bitmap representing the payment 
instrument are provided to the requesting consumer. Figure 30 illustrates a certificate 
issuance response in accordance with a preferred embodiment. An approved bitmap for a VISA 
card is shown at 3000. Also a default payment holder 3010 and a default payment holder 
name are provided with the certificate issuance. After the consumer aquires the payment 
instrument holder 3010, the payment instrument holder is immediately visible to him in his 
collection of payment instrument holders. Figure 31 illustrates a collection of payment 
instrument holders in accordance with a preferred embodiment. The predefined payment 
instrument holder 3100 is the same JOHN'S WALLET that was predefined based on defaults by 
the certificate issuance form. Figure 32 illustrates the default payment instrument bitmap 
3200 associated with the predefined payment instrument holder 3210 resulting from the 
consumer filling in and obtaining approval for a VISA card. 

Figure 33 illustrates a selected payment instrument with a fill in the blanks for the cardholder 
in accordance with a preferred embodiment. Next time the payment instrument holder is 
opened in a payment context the certificate issuing authorty's approved instrument bitmap can 
be used to select the payment instrument and utilize it to make purchases. Figure 34 
illustrates a coffee purchase utilizing the newly defined VISA card in accordance with a 
preferred embodiment of the invention. 

Figure 35 is a flowchart of conditional authorization of payment in accordance with a preferred 
embodiment. Processing commences at 3500 where the program initializes the connection 
betweeen the cardholder and the merchant for the purposes of shopping. After the cardholder 
completes shopping, a new SSL connection is established which provides authenticating 
information to the merchant. At this point the merchant is able to execute payment functionality 
(based on SSL or SET) conditionally, based upon the quality and character of the digital signature 
and the certificate used to validate said signature. Then, at function block 3510, the cardholder 
selects the payment instrument for the particular transaction. Payment instruments could 
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include VISA, MASTERCARD, AMERICAN EXPRESS, CHECK, SMARTCARD or DEBIT CARDS. 
The payment method is then submitted to the merchant at function block 3520. The merchant 
then initializes the SET connection to the acquiring bank at function block 3530 if the 
connection is not already established. Then, at function block 3540, the certificate is 
5 submitted to the merchant from the acquiring bank. The certificate includes a public key 

portion and a private key used as an irrebutable digital signature to authenticate the parties to 
the transaction. The certificate also includes information on the level of credit risk which 
allows a merchant to conditionally decide on the authorization or rejection of credit under a 
particular payment instrument based on their risk level and the merchant's personal comfort 
10 level with the ability of the cardholder to pay. This processing has not previously been possible 
because the information returned from the authorizing bank did not include a level of credit 
risk a cardholder posed, it only contained credit rejected or approved. 

A detailed description of the gateway internals is presented below in accordance with a 
1 5 preferred embodiment. 

Gw ClearSetReouestHandler 

Figure 51 depicts a flow diagram for the GatewayClearSetRequestHandler routine. Execution 
begins in Step 5105. In Step 5110 an SET analysis routine is called to analyze the SET 

20 request, as will be more fully disclosed below. Step 5110 sets a status flag indicating the next 
stage to be performed by the Gateway. In Step 5120 the Gateway checks to see whether the 
status is set to indicate that a response should be provided to the user. If so, execution 
proceeds to Step 5190, which ends the request handling routine and returns control to a 
calling routine, which then provides a response to the user. Otherwise execution proceeds to 

25 Step 5130. In Step 5130, the Gateway checks to see if the status is set to indicate that • 
forward translation is required. Forward translation is necessary to translate an outgoing 
message into a format that can be understood by the host computer. If forward translation is 
indicated, execution proceeds to Step 5135. In Step 5135, the outgoing message is forwarded 
translated, as more fully disclosed below with respect to Figure 53. If no forward translation is 

30 indicated, for example, if an already-translated transaction is being retried, execution proceeds 
to Step 5140. In Step 5140, the Gateway checks to see if the next step is communication to 
the host. If so, the Gateway proceeds to Step 5145, and initiates host communication as will 
be more fully discussed below with respect to Figure 54. If not, execution proceeds to Step 
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5150. In Step 5150, the Gateway checks to see whether reverse translation is indicated. 
Reverse translation translates a response from a host into a format useable by the calling 
routine. If reverse translation is indicated, execution proceeds to Step 5155, and the reverse 
translation is performed, as will be more fully discussed below with respect to Figure 55. In 
any case, after either forward translation in Step 5135, host communication in Step 5145, or 
reverse translation in Step 5155, control returns to Step 5120 for further processing. As will 
be more fully disclosed below, the forward translation, host communication, and reverse 
translation routines manipulate status indicators to prevent the occurrence of an infinite loop. 

The Gw_ClearSetRequestHandler routine as depicted in Fig. 51 may be implemented using the 
following C++ code: 

int Gw_ClearSetRequestHandler(CPCLRequest*pRequest) 



>GetContext(); 

action = setTrans->AnalyzeSetRequest(pVehicle^6fatalError); 

while ( (action!=»GW.PROCEED_TO_RESPOND)&& (IfatalError) ) ( 
switch (action) ( 
case GW_PROCEED_TO_FWDJCLAT: 

action * setTrans->TranslateForward(pVehicle); 
break; 



gwAction 
char 



action; 
fatalError; 



CPCLCCRequest 
CGW_Engine 



*pVehicle= (CPCLCCRequest*) pRequest; 
♦setTrans- (CGW_Engine *) pVehicle- 



case GWJPROCEED_WlTH_HOSTj:OMMS: 

action * setTrans->DoHostCommunication(pVehicle); 



WO 98/05011 



- 179- 



PCT/US97/13673 



break; 



case GW_PROCEED_TO_REVJCLAT: 

action = setTrans->TranslateReverse(pVehicle); 
break; 

case GW_PROCEED_TO_RESPOND: 
default: 
break; 

) 

) 



/ / Response should be built, return up the protocol 
/ / stack so that it will encode and then crypt our response, 
if (fatalError) | 

/ / Set an error code for the protocol stack. 

pVehicle->SetError(eEInvalidRequest); 

return(O); 

1 

else! 

retum(l); 

} 

\ 



Analzgcge tRfeflttcgt 

Figures 52A and 52B describe the AnalyzeSetRequest routine. This routine is by Step 5110 a 
illustrated in Figure 51. Execution begins in Step 5200. In Step 5205 the various fields in th 
SET record are obtained, as will be more fuUy disclosed below with respect to Figures 56A and 
56B. In Step 5210 the Gateway checks the retry count. A retry count is zero indicates that 
the request being analyzed is a new request, and control proceeds to Step 5212, indicating a 
new request. If the retry account is non-zero, this means that the request is a retry of a prior 
request, and control proceeds to Step 5214 where a retry is indicated. 
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Following either step 5212 or 5214, execution proceeds to Step 5215, In Step 5215 the 
Gateway checks to see whether the request represents a "stale request," as will be more fully 
described below with respect to Figure 57. In Step 5220, the Gateway tests the result of the 
5 stale check from Step 5215. If the request is stale it is marked as stale in Step 5222. 

Otherwise the record is marked as not stale in Step 5224. Following either Step 5222 or Step 
5224, control proceeds to Step 5230. In Step 5230 a message representing the SET request is 
inserted into the database for tracking purposes, and control proceeds to Step 5240. 

10 In Step 5240 the Gateway checks to see if the request had been marked stale in Step 5222. If 
so, it proceeds to Step 5242, exiting with an error condition. In Step 5245, the Gateway 
attempts to retrieve from the database a message corresponding to the current SET request, as 
will be fully disclosed below with respect to Figure 59. Step 5260 checks to see whether the 
message was successfully retrieved from the database. If the message was not found in the 

15 database, this indicates that the SET request represents a new message, and control proceeds 
to Step 5270. In Step 5270 a new message representing the SET request is added to the 
database, as is more fully disclosed below with respect to Figure 60. Because this is a new 
request, it must be processed from the beginning, including forward translation. Therefore, 
after the new message is added in Step 5270, control proceeds to Step 5275. In step 5275, 

20 where a status flag is set indicating that the next step to be performed for this message is for 
translation. If the message was found in Step 5260, this indicates that the request represents 
a request that is already in progress. Therefore, control proceeds to Step 5280 to update the 
database with current information representing the request status. The update process is 
described in further detail with respect to Figure 61, below. Following Step 5280, control 

25 proceeds to Step 5282. In Step 5282 the Gateway checks to see the disposition in which the 
SET request was left as a result of partial processing. This is done, for example, by 
interrogating fields in the database record that indicate the steps that have already been 
performed for this request. In Step 5283, based upon this status information, the Gateway 
indicates the next stage of processing to be performed: either forward translation, reverse 

30 translation, or communication with the host. After this status has been set, whether for a new 
request in Step 5275, or for an already-existing request in Step 5283, control proceeds to Step 
5290, which exits the AnalyzeSetRequest routine, returning control to Step 5110 in Figure 51. 
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The AnalyzeSetRequest routine as depicted in Figs. 52A and 52B may be implemented using 
the following C++ code: 

gwAction CGW_Engine::AnalyzeSetRequest(CPCLCCRequesf pVehicle, char 

♦fatalError) 

I 

gwAction action; 
gwDBRC dbrc; 
gwRC rc; 
int retryCount; 
char staleMsgFlag; 



*fatalError = _FALSE; / / Default to "all is OK\ 

/ / Extract the key SET fields that are required. The key 

/ / SET fields contain the primary key elements of the M setmsg" 

// table. 

if ( (rc=GetSetKeyFields(pVehicle))!- GW_SUCCESS) { 
switch (rc) [ 
case GW.NOT.SUPPORTED: 

BuildSetErrorResponse(pVehicle,ISO_RESP_FUNC_NOT_SUPP); 

break; 
default: 

BuildSetErrorResponse(pVehicleJSO^RESP_SYS_MALFUNC); 
break; 

) 

*fatalError=_TRUE; / / Only place we return this? 
return (GW_PROCEEDJTO_RESPOND); 

1 

else { 

/ / Set this so that the front-end will be able to tell 
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/ / whether enough information was derived from the request 
//in order to do update the "setmsg" log. 
m_haveKey Fields* 1; 

I 

/ / If the count of SET messages with current xid and rrpidbase is 
/ / non-zero then the message is an honest retry otherwise it 
/ / is a new request. 

if ( (dbrc=Gwdb^GetSetMsgRetryCount(8sretryCount)^= s GWDB_SUCCESS) { 
if (retryCount== 0) 

m_setRequestClass= GW_SREQCL_NEW_REQUEST; 

else 

m_setRequestClass = GW_SREQCL_HONEST_RETRY; 

) 

else { 

BuildSetErrorResponse(pVehicleJSO^RESP_SYS_MALFUNC); 
GW_LogError( LOG_ERR, "Gwdb_GetSetMsgRetryCount(): %d", dbrc); 
return (GW_PROCEED_TO_RESPOND); 

1 

/ / Check whether the message is stale. If it is, we still 

/ / insert it into the database shortly but we will not process 

//it. 

GwdbJsSetMsgStaie(&staleMsgFlag); 
if (staleMsgFlag— _TRUE) 

m_setRequestDisposition= GW_SREQDLSTALE; 

else 

m_setRequestDisposition= GW_SREQDLOK; / / Not stale. 

/ / Log the "SET message" in the database. If the insert fails 
/ / then we must have a replay attack! 
dbrc ■ GwdbJnsertSetMsg(); 



WO 98/05011 



- 183- 



PCTAJS97/13673 



10 



15 



20 



25 



switch (dbrc) | 
case GWDB_SUCCESS: 
break; 

case GWDB_DUPLICATE_ONJNSERT: 

BuildSetErrorResponse(pVehicleJSO^RESP^SECURITY_V10LATION); 

dbrc = GwdbJnsertReplayAttack(); 
if (dbrc GWDB.SUCCESS) { 

GW^LogError(LOGJERR, "GwdbJnsertReplayAttack(): %d\ dbrc); 

I 

return (GW_PR0CEED_T0_RESPOND); 
break; 
default: 

BuildSetErrorResponse(pVehicle,lSO„RESP.SYS^MALFUNC); 
GW_LogError(LOG_ERR, "GwdbJnsertSetMsgQ: %d", dbrc); 
return (GW_PROCEED_TCLRESPOND); 
break; 



/ / If the message is stale do no more. 

if (m_setRequestDisposition~ GWJSREQDLSTALE) { 

BuildSetErrorResponsetpVehicleJSO.RESP.SECURITY^VIOLATlON); 

return (GWJ>ROCEED_TO_RESPOND); 

I 

/ / If we reach this far in this function then: 



// 
// 
// 



i) the request is new or an honest retry AND 

ii) the request is not stale AND 

iii) a setmsg record has been added for this request. 



/ / If there is already a "host message" then update the key 
/ / with the new retry count. !f there was not a "host message" 
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// then insert one. 

dbrc = Gwdb_GetHostMsg(); 

switch(dbrc) { 
case GWDB_SUCCESS: 

dbrc = Gwdb_UpdateHostMsgKeys(); 
break; 

case GWDB_ROW_NOT_FOUND: 
dbrc = Gwdb_lnsertHostMsg(); 
if (dbrc !- GWDB_SUCCESS) ( 

BuildSetErrorResponse(pVehicle,lSO_RESP_SYS_MALFUNC); 

I 

retum(GW_PROCEEDJTO_FWD_XLAT); 
break; 
default: 

BuildSetErrorResponse(pVehicle,ISO_RESP_SYS_MALFUNC); 
GW_LogError( LOG.ERR, M Gwdb_GetHostMsg{) : %d\ dbrc); 
return (GW_PROCEEDJTO_RESPOND); 
break; 



if (dbrc != GWDB_SUCCESS) { 

BuildSetErrorResponse(pVehicle r ISO_RESP^SYS,MALFUNC); 
GW_LogError( LOG.ERR, "Gwdb_UpdateHostMsgKeys(): %d M , dbrc); 
return (GW_PROCEED_TO_RESPOND); 

) 

/ / If this request is an honest retry then determine if we 
/ / can "short circuit" a) the forward translation, b) the 
/ / communications to the host or c) the reverse translation 
// all of which will save time. 

if (m_setRequestClass== GW_SREQCL_HONESTRETRY){ 
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1 



switch (mJiostResponseDisposition)( 
case GW_HRESDI_UNKNOWN: 

action = GW.PROCEED JTO_FWD JCLAT; 
break; 

case GW_HRESDI_RECEIVED_OK: 

action = GW_PROCEEDJTO_REVJ(LAT; 
break; 

case GW_HRESDI_REV_XLAT_F AILED: 
action = GW_PROCEED_TO_REV_XLAT; 
break; 

case GW_HRESDI_RECEIVE_FAILED: 
case GW.HRESDLTIMEOUT: 

action = GW J>ROCEED JVITH JiOST.COMMS; 

break; 

default: 
break; 



return (action); 



Translate Forward 

Figure 53 depicts the execution of the Translate Forward routine, which is called by Step 
5135 in Figure 61. Execution begins at Step 5310. In Step 5320 r the Gateway forward- 
translates the request to prepare it for transmission to the host. Forward translation consists 
of packaging the fields in the request into a format that is understandable by the legacy system 
at the financial institution. The exact format of the translated request will vary from institution 
to institution- However, in general, the format will consist of a fixed length record with 
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predetermined fields, using a standard character set such as ASCII or EBCDIC. In Step 5330, 
the Gateway checks to see whether the translation was successfully performed. If not control 
proceeds to Step 5340, which returns an error condition. If the translation was successful, 
control proceeds to Step 5350. In Step 5350, the Gateway sets a status flag to indicate that 
5 the next stage to be performed for this SET request is to proceed to host communication. This 
will be used in the next iteration of the Gw_ClearSetRequestHandler routine as depicted in 
Figure 51. After the status is set in Step 5350. the translate forward routine returns control in 
Step 5360. 

The TranslateForward routine as depicted in Figure 51 may be implemented using the 
10 following C++ code: 



gwActionCGW_Engine::TranslateForward(CPCLCCRequesfpVehicle) 

gwRC rc; 
15 gwDBRC dbrc; 

rc * HM_TranslateForward(m_hostSpecificMessagepVehicie); 

if(rc==GW_SUCCESS){ 
20 return (GW_PROCEEDJVlTH_HOST_COMMS); 

} 

m_hostRequestDisposition* GW_HREQDLFWD_XLAT_FAILED; 
BuildSetErrorResponse(pVehicle,ISO„RESP_FORMAT_ERR); 

25 

dbrc = Gwdb_UpdateHostMsgRequestDisp(); 
if (dbrc != GWDB_SUCCESS) { 

GW_LogError( LOG_ERR, "Gwdb_UpdateHostMsgRequestDisp(): %d\ 

dbrc); 

30 } 



return (GW_PROCEED_TO_RESPOND); 
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1 

DoHostCommiinication 

Figure 54 depicts the step of host communication, as shown in Step 5145 in Figure 51. 
5 Execution begins in Step 5400. In Step 5405 the Gateway obtains from the request object the 
string representing the request text. In Step 5410 it obtains the sequence number for the 
request. In Step 5415 the Gateway determines the current time, in order to record the time at 
which the request is made. In Step 5420 the Gateway sends the request to the host and waits 
for a response from the host. When a response is received, execution continues in Step 5425. 

10 In Step 5425, the Gateway again checks the current time, thereby determining the time at 
which a response was received. In Step 5430, the Gateway checks to see whether the 
communication was successfully performed. If a communication was not successful, the 
Gateway records that an error occurred in Step 5432. If the communication was successful, 
the Gateway, in Step 5435, indicates that the request was successfully sent and responded to. 

15 In Step 5437, the Gateway sets the response string based upon the response received in Step 
5420. In Step 5439 the Gateway sets a status to indicate that reverse translation of the 
received response is required. Regardless of whether the communication was successful or 
unsuccessful, execution continues to Step 5450. In Step 5450, the database is updated with 
status information from the host communication. In Step 5490, control is returned to the 

20 calling routine. 

The DoHostCommunication routine as depicted in Fig. 54 may be implemented using the 
following C++ code: 

25 gwActionCGW_Engjne::DoHostCommunication(CPCLCCReque3fpVehicle) 
( 

gwHMRC hmrc; 
gwDBRC dbrc; 

gwAction action = GW.PROCEEDJTCLRESPOND; 

30 

unsigned char hostRequestMessage[HOSTREQJ3Z+ 1 ]; 
int hostRequestLength - 0; 
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unsigned char hostResponseMessage(HOSTREQ_SZ+l]; 
int hostResponseLength= 0; 

long sequenceNo; 

HM_GetRequestString(ni_hostSpecificMessage,&hoslRequestMessage[0], 

&hos tRequestLength) ; 

HM_GetSequenceNo( m_hostSpecificMessage,&sequenceNo ); 

time( &m_hostRequestTime); 

hmrc = SendToHostAndWait( 

&hostRequestMessage[0],hostRequcstLength, 
&hostResponseMessage[0],&hostResponseLengtn); 

time( &m_hostResponseTime); 

switch (hmrc) { 
case GWHM_SUCCESS: 

m_hostRequestDisposition=GW_HREQDI_SENT_OK; 
m_hostResponseDisposition= GW_HRESDI„RECE1VED_0K; 
HM^SetResponseString(m.hostSpecificMessage,&hosiResponseMessage(0], 

hostResponseLength); 

action = GW_PROCEED_TO_REV_XLAT; 
break; 

case GWHM_SEND_FAILED: 

m_hostRequestDisposition= GW_HREQDLSEND_FAILED; 
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m_hostResponseDisposition=GW.HRESDLUNKNOWN; 
break; 



case GWHM_RCV_FAILED: 

m_hostRequestDisposition- GW_HREQDI_SENT_OK; 
m^hostResponseDisposition=GW^HRESDI_RECEIVE_FAILED; 

break; 



case GWHM.RCVTIMEOUT: 

m_hostRequestDisposition* GW_HREQDLSENT_OK: 

m^hostResponseDisposition=GW_HRESDLTiMEOUT; 

break; 



default: 
break; 

i 

if (hmrc !- GWHM_SUCCESS) { 

BuUdSetErrorResponse(pVehicle,ISO„RESPJSSUER_INOP); 

I 

dbrc = Gwdb_UpdateHostMsgAllInfo(sequenceNo, 

&host RequestMessage [0] , hostRequestLength, 
&hostResponseMessage[0],hostResponseLength); 

if (dbrc != GWDB_SUCCESS) { 

BuildSetErrorResponse(pVehicle,lSO..RESP.SYS.MALFUNC); 
GW_LogError(LOG^ERR/Gwdb^UpdaieHostMsgA]Unfo!): %d M , dbrc); 

} 

return (action); 

I 

TranslateReverse 

Figure 55 depicts the operation of the TranslateReverse routine, as executed in Step 5155 in 
Figure 51. Execution begins at Step 5500. In Step 5510 the Gateway reverse-translates the 
response received from the legacy system host. Reverse translation consists of extracting data 
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from the data records received from the legacy system, and placing them in objects so that they 
are useable by the Gateway. In Step 5520, the Gateway checks to verify that translation was 
successful. If translation was successful control proceeds to Step 5530, where a status flag is 
set indicating a successful translation. If translation was not successful, control proceeds to 
5 Step 5540, in which the Status Flag is set to indicate an unsuccessful translation . Regardless 
of whether translation was successful or unsuccessful, execution proceeds to Step 5550. In 
Step 5550, a status flag is set to indicate that the next stage for the request is to provide a 
response from the Gateway. This step is always executed, because, regardless of whether the 
translation or any other aspect of the transaction was successful, a response indicating either 

10 success or failure must be returned by the Gateway. Control then proceeds to Step 5590, in 
which the TranslateReverse routine returns control to the calling routine in Figure 51. It will 
be seen that the Translate Forward routine in Figure 53, the DoHostCommunication routine 
depicted in Figure 54, and the TranslateReverse routine depicted in Figure 55, each alter the 
status of the request. As a result as the loop depicted in Figure 51 executes a particular 

1 5 request will proceed through all three stages and finally to exit in Step 5190. 

The TranslateReverse routine as depicted in Figure 55 may be implemented using the following 
C++ code: 

gwAction CGW^Engine::TranslateReverse(CPCLCCRequesfpVehicie) 

20 I 

gwRC rc; 
gwDBRC dbrc; 
rc a HM_TranslateReverse(m_hostSpeciflcMessagepVehicle); 
if (rc « GW_SUCCESS) { 
25 / / Success; we have a normal PDU to send back to VPOS! 

/ / If there is any problem further to this (eg: PC L /ASN libs) 
/ / that the frond-end is responsible for calling the method 
/ / LogSetErrorResponseQon this engine instance. 
m_setResponseClass= GW_SRESCLJVPP_NORMAL_PDU; . 
30 m_setResponseDisposition= GW_SRESDLSENT_OK; 

HM_GetResponseCode(m_hostSpecificMessagern_setResponseCode); 
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15 



clse( 

m_hostResponseDisposition» GW_HRESDLREV_XLAT_FAILED; 
BuildSetErrorResponse(pVchicIcJSO.RESPJNVAUD.RESPONSE); 

dbrc = Gwdb_UpdateHostMsgResponseDisp(); 
if (dbrc != GWDB_SUCCESS) { 

GW_LogError( LOG_ERR, H Gwdb^.UpdateHostMsgResponseDisp(): 

%d", dbrc); 



10 ! 



/ / Whether there was a translation error or not we need to respond, 
return (GW_PROCEED_TO_RESPOND); 



GctSetKevFiclds 

Figures 56A and 56B describe the GetSetKey Fields routine. This routine is called by Step 5205 
as illustrated in Figure 52A. Execution begins in Step 5600. In Step 5610, the Gateway 
interrogates the request object to determine the request type. In Step 5620, the Gateway 

20 determines whether the request type is for authorization only. If the request type is not for 

authorization only, execution proceeds to Step 5625. In Step 5625, the Gateway checks to see 
whether the request type is for a sale. If the request type is neither for authorization only nor . 
for a sale, execution proceeds to Step 5630. In Step 5360, the Gateway indicates that the 
request type is not a supported request, and proceeds to Step 5635, where it returns to the 

25 caller. 

If the request type is either for authorization only or for a sale, execution proceeds with Step 
5640. In step 5640, the Gateway initializes a container object to represent the request. In 
Step 5650, the Gateway extracts the (transaction identifier?] (X1D) for the transaction. In Step 
30 5652, the Gateway extracts the merchant identifier (MID) for the transaction. In Step 5654, 
the Gateway extracts the (what is the RRPID?] (RRPID) and the terminal identifier (TID) for the 
request. In Step 5656, the Gateway extracts the retry count associated with the current 
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request. In Step 5660, a message data area is initialized with the extracted contents. The 
message area can then be used for further processing by the called routine. In Step 5690, the 
GetSetKey Fields routine returns control to the caller. 

5 The GetSetKey Fields as depicted in Figures 56 A and 56B may be implemented using the 
following C++ code: 

gwRC CGW_Engine::GetSetKeyFields(CPCLCCRequesfpVehicle) 

( 



10 



gwRC 1 
unsigned int got; 



transRc = GW_SUCCESS; 



char 



s_RrpidTid|2*XID_SZ]; 



unsigned long - rrpid; 



15 



unsigned long tidOffset; 

m_setKeyFields.reqType= pVehicle->GetRequestType(); 
switch (m_se tKey Fields. reqTy pe){ 
case CPCLRequest::CCAuthOnly: 
case CPCLRequest::CCSale: 



20 



/ / Initial cast to correct subclass. 
CASNAuthorizationRequestDataContainer* s_req 35 



((CPCLCCAuthOnlyRequest*)pVehicle)->GetRequestContainer()- 



>get_data(|->get_data(); 



25 



//xid 

s_req->get_transactionJdO->get_x_id()-> 

get_value( (unsigned char *) &m_setKeyFields.xid ? XID_SZ t &got); 



//mid 



#ifdefJUNE_3RD 

stxncpy(m_setKeyFields.mid/4258 1" , MID_SZ); 



30 



#else 



/ / TODO: get code from Deepak for pulling MID out of s_req! 
stmcpy(m_setKeyFields.mid/42581 M ,MID_SZ); 
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10 



//bah! 



#endif 



NOTE: We have agreed with VPOS team that the RRPID field 
will contain the following: 

<rrpid> <space> <tid> <null> 

where <rrpid> is a string representing the rrpid value 
and <tid> is a string representing the tid value. 



memsetts^RrpidTidAO', sizeof(s_RrpidTid)); 

15' 

s_req->getJ\uthorizationRequest£)ata_extensions()-> 
get_auth_req_res_pair_id()-> 

get_value( (unsigned char *) &s_RrpidTid, sizeof(s_RrpidTid),&got); 

20 / / get rrpid and offset to the tid. 

sscanf(s.RrpidTid,"%d %n*\ &rrpid, fctidOffset); 

/ / rrpidBase and retryCount 
m_setKey Fields. retry Count- rrpid % 100; 
25 m_setKeyFields.rrpidBase- rrpid - m_setKey Fields. retryCount; 

//tid 

strncpy(m^setKeyFields.tid,(s_RrpidTid+udOffset| f TID^SZ); 

30 // rcqDate 

GW„GetTimeFromASNTime(&(m^setKeyFields.merchantTim^ 
s.req->get.authorization_request..date(|; 
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break; 



case CPCLRequest::CCAuthReversal: 
case CPCLRequest::CCCreditReversal: 
case CPCLRequest::CCCapture: 
case CPCLRequest::CCCredit: 



(} « Refund | Return 



// == Void 



case CPCLRequest::CCCaptureReversal: / / == Void 
/ / case eBallnquiry: 

transRc - GW_NOT_SUPPORTED; 
break; 

default: 

transRc = GW_NOT_SUPPORTED; 
break; 

} 

// Initialize the host message will with the key fields "in the clear"! 
if (m_hostSpecificMessage== NULL) { 
transRc = GW.FAJLED; 

I 

else{ 

HM_Initiali2e(m^hostSpecificMessage,&m.setKeyFields); 

) 

return (transRc); 



Gwdb IsSetMsgStale 

Figure 57 depicts the GwdbJsSetMsgStale routine. This routine is called by Step 5215 as 
illustrated in Figure 52A. Execution begins in Step 5700. Ir Step 5710, the Gateway checks 
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to see whether this is the first time the GwdbJsSetMsgStale has been called for this request. If 
this is the first time, Steps 5715 through 5730 are performed; otherwise those steps are 
skipped. In Step 5715, a field representing the message life is initialized to a predetermined 
duration. The message life is a field that will be used to determine how long the message 
5 representing the transaction will remain valid. The use of the message life field prevents a 
transaction that is effectively lost due to extensive processing delays from being processed. In 
Step 5720, the Gateway checks to see if the value of the message life is equal to zero. If the 
message life is equal to zero, a default value, i.e., 300 seconds or 5 minutes, is assigned to the 
message life in Step 5725. In Step 5730, an indicator for this request is set to indicate that 
1 0 first time processing has already been performed for this request. This flag is the same flag 

interrogated in Step 5710, and is used to prevent successive reinitialization of the message life 
field. 

In Step 5740, the Gateway checks to see whether the merchant's time stamp, plus the value of 
1 5 the message life, is less than the time of the request. If so, then the request is considered stale, 
and is marked stale in Step 5750. If not, the request is not stale, and is marked not stale in 
Step" 5755. Following either of Step 5750 or 5755, the GwdbJsSetMsgStale exits in Step 
5790. The GwdbJsSetMsgStale routine as depicted in Figure 57 may be implemented using 

the following C++ code: 
20 void CGW_Engine: :G wdb_IsSetMsgStale(char*staleFlag) 

I 

static char go tStale Duration^ ; 
static long setMsgLife; 

static char *funcName = GwdbJsSetMsgStale"; 
25 . / / Only get this once per process lifetime, 

if (gotStaleDuration »- 0) { 
FILE *fp; 

char duration[INI_MAXLNSZ+ 1 ]; 
if ( (fp=OpenIniFile())!= NULL) { 
30 setMsgLife =0; 

(void) iniGetParameterlfp/GATEWAYADMIN", SetMsgLife", 

duration); 
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setMsgLife = atol(duration); / / could return 0; handled later, 
(void) CloselniFile(fp); 

> 

if(setMsgLife==0){ 
5 setMsgLife «= 5 * 60; / / Default to 5 minutes; 

) 

gotStaleDuration- 1; 

> 

// If the message has expired its lifetime. 
10 if ( (m_setKeyFields.merchantTime+setMsgLife)<: m_setRequestTime) 

*staleFlag = _TRUE; / / request is stale. 

else 

*staleFlag = _FALSE; / / honour request, it is not stale. 

return; 
15 } 

Qwdb InsertSetMsg 

Figure 58 depicts the GwdbjnsertSetMsg routine. This routine is called from Step 5230 as 
illustrated in Figure 52A, Execution begins in 5800. In Step 5810, the routine invokes a 

20 database insert function by, for example, executing an SQL INSERT command. In Step 5820, 
the database return code is obtained in order to be used as a return code from the 
GwbdJnsertSetMsg routine. In Step 5830, a database commit function is performed, thereby 
instructing the database engine to commit the database changes to a permanent recording, i.e., 
by writing the information to the file, and/or by journalizing the change made by INSERT 

25 function. In Step 5890, the routine returns control to the calling program. 

The GwdbjnsertSetMsg as depicted in Figure 58 may be implemented using the following C++ 
code: 

gwDBRC CGW_Engine::Gwdb_InsertSetMsg() 
30 { 

EXEC SQL BEGIN DECLARE SECTION; 
// Key. 
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char *h_xid - &(m_setKeyFields.xid[0]); 

long h.rrpidBase - m_setKeyFields.rrpidBase; 

int h.retryCount - m_setKey Fields, retry Count; 

/ / Columns to insert into. 
5 char *h_mid s &(m_setKeyFieids.mid[0]); 

char *h_tid * &(m_setKeyFields.tid[0]); 

char h_merchantTime(26]; 

int h.requestType = (int) m_setKeyFields.reqType; 

char h_requestTime(26] ; 
10 int h_requestClass - (int) m_setRequestClass; 

int h_requestDisposition = (int) m_setRequestDisposition; 

char h_responseTime[26); 

int h_responseClass - (int) m.setRequestClass; 

int h_responseDisposition - (int) m.setResponseDisposition; 

15 char *h_responseCode , « m_setResponseCode; 

EXEC SQL END DECLARE SECTION; 
static char *funcName = "GwdbJnsertSetMsg"; 
gwDBRC dbrc; 

GW_MakeDateString(h,merchanlTime t &(m^setKeyFields.merchantTime))^ 
20 GW_MakeDateString(h_requestTime,&m_setRequestTime); 

GWJrfakeDateString(h_responseTime#m_setResponseTime); 
EXEC SQL INSERT INTO setmsg 
( 

xid, rrpidbase, retrycount. mid, tid, 
25 merchanttime, 

requesttype, 
requesttime, 

requestclass, requestdisposition, 
responsetime, 

30 responseclass, responsedisposition,responsecode 

' ) 
VALUES 
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( 

:h_xid, :h_rrpidBase t :h_retryCount, :h_mid, :h_tid, 
TO_DATE(:h_merchantTime/DY MON DD HH24:MI:SS YYYY'}, 
:hjrequestType, 

5 TO_DATE(:h_requestTime,'DY MON DD HH24:MI:SS YYYY ), 

:h_requestClass f :h_requestDisposition, 
TOJMTE(:h_responseTime,'DY MON DD HH24: MI:SS YYYY'), 
:h_responseClass,:h_responseDispositiori f :h_.responseCode 

); 

10 

dbrc = DbJSiTor(funcName); 
(void) Db_Commit(funcName); 
return (dbrc); 

) 

15 

Gwbd GetHostMsg 

Figure 59 depicts the Gwbd_GetHostMsg routine. This routine is called by Step 5245 as 
shown in Figure 52B. Execution begins in Step 5900. In Step 5910, the routine invokes a 
database select function by, for example, executing an SQL SELECT command. In Step 5920, 

20 the database return code is obtained in order to be used as a return code from the 

GwbdJnsertSetMsg routine. In Step 5930, the Gateway checks to see whether the database 
retrieve operation was successfully performed. If so, execution proceeds to Step 5935. In Step 
5935, the Gateway sets a number of status variables from the values retrieved from the 
database records. This includes the time the request was made, the time a response was 

25 received, the contents of the request string, the contents of the response string, and a sequence 
number for this request. In Step 5940, a commit operation is performed. [What is the point of 
a commit operation following a retrieval, as opposed to an insert or an update?) In Step 5900, 
control returns to the calling program. 

30 The Gwdb_GetHostMsg as depicted in Figure 59 may be implemented using the following C++ 
code: 

. gwDBRC CGW_Engine::Gwdb_GetHostMsg() 



WO 98/05011 



- 199- 



PCT/US97/13673 



I 

struct tm requestTimeTM; 
struct tm responseTimeTM; 
EXEC SQL BEGIN DECLARE SECTION; 
//Key. 

char *h_xid s &(m - setKeyFields.xid[0)); 

long h.rrpidBase - m_setKeyFields.rrpidBase; 

// Indicator Variables. 

short h_requestStringInd; 

short h_responseStringInd; 
/ / Columns to retreive. 

long h_sequenceNo = 0; 



int *h_reqYear* &requestTimeTM.tm_year; 

int *h_reqMonth = &requestTimeTM.tm_mon; 

int *h_reqDay = 6VequestTimeTM.tm_mday; 

int *h_reqHour = &requestTimeTM.tm_hour; 

int *h_reqMinute = &requestTimeTM.tm_min; 

int * h_reqSecond - &requestTimeTM . tm_sec; 

int *h_requestDisposition * (int *) &m_hostRequestDisposition; 

VARCH AR h_requestString[ 1 28] ; 

int *h_resYear = &responseTimeTM.tm_year; 

int *h_resMonth = &responseTimeTM.tm_mon; 

int *h_resDay = &responseTimeTM.tm_mday; 

int *h_resHour = &responseTimeTM.tm_hour; 

int *h_resMinute - &responseTimeTM.tm_inin; 

int *h_resSecond = &responseTimcTM.tm_sec; 

int *h_responseDisposition = (int *) &m_hostResponseDisposition; 



VARCHAR hj-esponseString[128); 
EXEC SQL END DECLARE SECTION; 

static char *funcName = , •Gwdb_GetHostMsg ,, ; 
gwDBRC dbrc; 

/ / Set the "tm" structures to null. Set tm Jsdst to - 1 so that the 
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/ / mktime() function will determine if whether Daylight Savings Time 
/ / is active. 

memset(&requestTimeTM,'\0\ sizeof(tm) ); 
requestTimeTM.tmJsdst=- 1; 
memsett&responseTimeTM.'VO", sizeof(tm) ); 
responseTimeTM.tm_isdst=-l ; 

EXEC SQL SELECT 
sequenceno, 

TO_NUMBER( TO_CHAR(requesttime/YYYY'))- 1900, // see "man 

mktime" 

TO_NUMBER(TO_CHAR(requesttime/MM , ))-l, // see "man 

mktime" 

TO_NUMBER( TO.CHARIrequesttime/DD*)), 
TO_NUMBER( TO_CHAR(requesttime,'HH24')) , 
TO„NUMBER(TO^CHAR(requesttime/Mr)) t 
TO_NUMBER(TO_CHAR(requesttime/SS')), 
requestdisposition, requests tring, 

TOJWMBER(TO_CHAR(respons<time/YYYY'))- 1900, / / see "man mktime" 
TOJYUMBER(TO_CHAR(responsetime,'MM'))- 1 , / / see "man mktime" 
TO^NUMBERfrO.CHARfresponsetime/DD')), 
TO_NUMBER(TO_CHAR(responsetime,HH24)) I 
TO_NUMBER(TO_CHAR(responsetime,'Mr)), 
TO_NUMBER(TO_CHAR(responsetime/SS')), 
responsedisposition,responsestring 

INTO 
:h_sequenceNo, 

:h_reqYear, :h_reqMonth, :h_reqDay, :h_reqHour, :h_reqMinu:e. :h_reqSecond, 
th.requestDisposition^h^requestStringrh^requestStringlnd, 
:h_resYear, :h_resMonth, :h_resDay, :h_resHour, :h_resMinute, :h_resSecond, 
:h_responseDisposition,:h_responseString:h_responseStringlnd 
FROM 
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hostmsg 
WHERE 

xid = :h„xid AND 
rrpidbase= :h_rrpidBase; 
dbrc = Db_Error(funcName); 
if (dbrc *= GWDB.SUCCESS) { 

if (h_requestStringInd== -1) h_requestString.len=0; 
if (h_responseStringInd=== -1) n_responseString.len=0; 
m_hostRequestTime = mktime( flsrequestTimeTM); 
m_hostResponseTime== mktime ( &responseTimeTM ); 
HM_SetRequestString(mJiostSpecificMessage, 
h_requestString.an\ 
h__requestString.len) ; 
HM_SetResponseString(mJiostSpecificMessage, 
h_responseString.aiT, 
h_responseString.len); 
HM^SetSequenceNolm^hostSpecificMessagch.sequenceNo); 

1 

(void) Db_Commit(funcNanie); 

return (dbrc); 

) 



Gwdb InsertHostMsg 

Figure 60 depicts the GwdbJnsertHostMsg routine. This routine is called by Step 5270 as 
illustrated in Figure 52B. Execution begins in Step 6000. in Step 6010, the routine invokes 
a database insert function by, for example, executing an SQL INSERT command. In Step 
6020, the database return code is obtained in order to be used as a return code from the 
GwbdJnsertSetMsg routine, in Step 6040, a commit operation is performed. In Step 6090, 
the routine returns control to the calling program. 

The GwdbJnsertHostMsg as depicted in Figure 60 may be implemented using the following 
C++ code: 
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gwDBRC CGW_Engine::GwdbJnsertHostMsg() 
{ 

EXEC SQL BEGIN DECLARE SECTION; 
// Key. 

5 char *h_xid - &(m_setKeyFields.xid[0]); 

long h.rrpidBase = m_setKeyFieIds.rrpidBase; 

int h_retryCount * m_setKeyFfeIds.retryCount; 

/ / Columns to insert into. 

long h_sequenceNo 3 0; 

10 char h_requestTime[26| ; 

int h.requestDisposition ■ (int) mJiostRequestDisposition; 

char h_responseTime(26|; 

int h_responseDisposition = (int) m_hostResponseDisposition; 

EXEC SQL END DECLARE SECTION; 
1 5 static char *funcName = "GwdbJnsertHostMsg"; 

gwDBRC dbrc; 

GW^MakeDateStringlh^requestTime.&m^hostRequestTinie); 
GW_MakeDateString(h_responseTime,&m_hostResponseTime); 
EXEC SQL INSERT INTO hostmsg 
20 ( 

xid, rrpidbase, retrycount, 
sequenceno, 
requesttime, 
requestdisposition, 
25 responsetirne, 

responsedisposition 

) 

VALUES 
( 

30 ihjrid, :h_rrpidBase, :h_retryCount, 

:h_sequenceNo, 

TO_DATE(:h_requesrTime/DY MON DD HH24:MI:SS YYYY'), 
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20 



: h_requestDisposition t 

TOJDATE(:h_responseTime/DY MON DD HH24:MI:SS YYYV), 
: h_responseDisposition 



dbrc - Db_Error(funcName); 
(void) Db^Commit(funcName); 
return (dbrc); 



10 Gwdb UpdateSetMsgResoonselnfo 

Figure 61 depicts a flow diagram for the GwdbJJpdateSetMsgResponselnfo routine. Execution 
begins at Step 6100. In Step 6110, the routine invokes a database update function by, for 
example, executing an SQL UPDATE command. In Step 6120, the database return code is 
obtained in order to be used as a return code from the GwbdJJpdateSetMsgResponselnfo 
15 routine. In Step 6190, the routine returns control to the calling program. 

The GwdbJJpdateSetMsgResponselnfo as depicted in Figure 61 may be implemented using the 
following C++ code: 

gwDBRC CGW_Engine: :Gwdb_UpdateSetMsgResponseInfo() 



EXEC SQL BEGIN DECLARE SECTION; 
// Key. 

char *h_xid = &(m_setKeyFields.xid[0]); 

long h_rrpidBase - m_ setKey Field s. rrpidBase ; 

25 int h_retryCount = m_ setKey Fields, retry Count; 



/ / Columns to update, 
char h_responseTime(26]; 
int h_responseCiass 
int h_responseDisposition 
char *h_responseCode 
EXEC SQL END DECLARE SECTION; 



- (int) m_setResponseCiass; 
* (int) m_setResponseDisposition; 
= m_setResponseCode; 
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static char *funcName = 'Gwdb_UpdateSetMsgResponseInfo"; 
gwDBRC dbrc; 

GW_MakeDateString(h„responseTime,66m_setResponseTime); 
EXEC SQL UPDATE setmsg SET 
5 responsetime* TO_DATE(:h_responseTime,'DY MON DD HH24:MI:SSYYYY), 

responseclass * :h_responseClass, 

responsedisposition - : h_xesponseDisposition, 

responsecode = :h_responseCode 
WHERE 

10 xid-:h_xidAND 

rrpidbase = :h_rrpidBaseAND 
retrycount = :h_retry Count; 
dbrc - Db_Error(funcName); 
(void) Db_Commit(funcName); 
15 return (dbrc); 

) 

Figure 62 is the main administration display for the Gateway in accordance with a preferred 
embodiment. A set of menu selections are presented at 6200 which will be described in more 

20 detail for each display. Figure 63 is a configuration panel in accordance with a preferred 
embodiment. The configuration panel provides access to management information for 
configuring a gateway management information database. The Merchant Identifier (Mid) 6310 
is a thirty character, alphanumeric field that uniquely defines a merchant. The Merchant 
Name 6320 is a fifty character, alphanumeric field, the Edit 6330 and Delete field 6340 are 

25 hyperlinks to detailed panels for modifying information in the management information 

database. Figure 64 is a host communication display for facilitating communication between 
the gateway and the acquirer payment host. The IP Address Field 6410 contains the Internet 
Protocol address for communicating via TCP/IP to the Internet. The TCP logical port field 6430 
uniquely identifies the port for accessing the Internet, and the SAVE field 6430 invokes storing 

30 of the host communication information in the database. Figure 65 is a Services display in 

accordance with a preferred embodiment. This display initiates portions of the Gateway such 
as the host mulitplixer 2130 of Figure 21. Figure 66 is a graphical representation of the 
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gateway transaction database in accordance with a preferred embodiment. Each of the fields 
represents a portion of the internet database schema in accordance with a preferred 
embodiment. 

5 In today's environment value is transferred from one smart card to another smart card by 
inserting cards one at a time into a personal computer, or a pair of personal computers 
connected by a dedicated line. A value transfer protocol is employed to transfer the value as 
described on the Modex Purse Functionality training material. The transactions are performed 
face-to-face with trusted hardware utilizing a secure, dedicated communication link. VeriFone 

1 0 Inc. , a leading global provider of secure payment solutions supports Mondex smart cards just 
as Visa, MasterCard or other credit cards are supported. This suppon enables VeriFone to 
offer hardware and software for "electronic cash" payment. VeriFone's family of smart card 
system products allows retail merchant and consumer Mondex smart cards to interface and to 
facilitate digital cash payments for all goods and services currently purchased with coins and 

15 currency. 

Mondex is a smart card-based electronic cash payment system being introduced by banks 
around the world. Because the icroprocessors contained on the Mondex smart cards can 
communicate securely with one another, cash-equivalent value can be stored in the cards, 
20 enabling consumers to purchase goods at retail stores and on the Internet. However, if the 
smart cards are utilized on the Internet without otherwise securing the transaction, 
interception and fraudulent transactions are possible. 

Solutions in accordance with a preferred embodiment enable merchants to add Mondex chip 
25 card capability to their existing applications. In addition to supporting the Mondex electronic 
cash system, VeriFone chip card payment solutions are available for processing smart 
card-based stored-value, credit and debit programs of other payment associations. Meeting 
high international security standards, the system features an integrated dual track reader that 
can run both magnetic stripe and smart card-based applications. Additionally, the optional 
30 graphics display supports a variety of icons, logos and various non-Roman character sets such 
as Arabic, Cyrillic, Chinese and Japanese. 
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Recently, the Internet was proposed as a communication medium connecting personal 
computers with specialized reader hardware similar to the Verifone hardware described above. 
However, the Internet is not a secure communication medium and value transfer was not 
secured. Thus, a solution was necessary to shore up the Internet with secure value transfer 
5 processing to facilitate smart card processing over the Internet. In addition, support was 
required to ensure that no third party could hijack a value transfer transaction. This would 
occur if someone diverted the transaction before it even started. In the prior art face-to-face 
solution, both parties can confirm the other party's identity. However, the Internet separates 
the parties with miles of wire. 

10 

Figure 67 is a block diagram of a secure method for transferring value from one smart card to 
another in accordance with a preferred embodiment of the invention. Devices 6700 and 6790 
are personal computers with chip card readers such as the Mondex purse described in the 
Mondex system documentation. Digital certificates 6740 and 6730 are utilized in conjunction 

1 5 with digital signatures to ensure that both parties are who they say they are. In addition, a 

secure transport protocol 6750, such as SHTTP or SSL as described above is utilized to ensure 
the information flowing over the Internet 6710 is secure. Digital certificates and digital 
signatures positively identify the parties and establish a secure communication link before 
beginning a transaction. Identity information could even be displayed before beginning the 

20 transaction to provide further security. Optionally, the display could indicate that a hierarchy 
was broken and present a suspicion factor to the user. Then, if a user demands confirmation 
before recommencing the transaction with the identified party, security would be maintained. 
The authenticating actions that the parties perform in addition to the exchange of digital 
certificates and signatures could also entail the exchange of parameters of the transfer. For 

25 example, how much money should be exchanged, what currency, the terms of the transfer 
such as interest, how long payments would last. Then, the chip card could begin its dialog 
with the corresponding chip card along the line of established procedures to exchange value. 

While various embodiments have been described above, it should be understood that they have 
30 been presented by way of example only, and not limitation. Thus, the breadth and scope of a 
preferred embodiment should not be limited by any of the above described exemplary 
embodiments, but should be denned only in accordance with the following claims and their 
equivalents. 
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CLAIMS 

What is claimed is: 



1 l. A method for initiating secure communication between a first computer and a second 

2 computer connected to a network for authenticating and transferring value from a first 

3 ^ smart card to a second smart card, comprising the steps of: 

4 (a) establishing a communication link between said first computer and said second 

5 computer via said network; 

6 (b) identifying a cryptographic procedure for utilization by said first computer and said 

7 second computer; 

8 (c) transmitting cryptographically secure authenticating information, from said second 

9 computer to said first computer using the communication link and said cryptographic 

10 procedure; 

1 1 (d) receiving said cryptographically secure authenticating information at said first 

12 computer using the communication link and processing the authentication information 

13 utilizing the cryptographic procedure to authenticate said second smart card and said 

14 first smart card; 

1 5 (e) reading said first smart card at the first computer; 

1 6 (f) reading said second smart card at the second computer; and 

1 7 (g) transferring value from said first smart card at the first computer to said second smart 

1 8 card at the second computer utilizing the network and said cryptographic procedure. 

1 2. The method as recited in claim 1, including the step of utilizing the Internet for 

2 transmitting information between said first computer and said second computer. 

1 3. The method as recited in claim 1, including the step of transmitting information from 

2 the second computer to a third computer for authorizing or denying credit in payment 

3 processing. 

1 4. The method as recited in claim 1 , wherein the encrypted payment information conforms 

2 to a Secure Sockets Layer protocol. 
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1 


5. 


A method for initiating secure communication between a first computer and a second 


2 




computer connected to a network for authenticating and transferring value from a first 


7 
J 




SiliaiT CaTQ allaCnCQ lO SalQ IirSL COIIipuicr lO a oCCOIiU olllcli i tciiu ci.llai.iicu it-/ a. acuuiiu 


4 




computer, comprising the steps of: 


5 


(a) 


obtaining authentication information for use in said secure transfer of value between a 


6 




first smart card and a second smart card; 


7 


(b) 


establishing a communication between said first computer and said second computer 


8 




via said network; 


9 


(c) 


repackaging said authentication information to comply with a secure protocol; 


1 A 
10 


(d) 


reading a first smart card at the first computer; 


11 


(e) 


reading a second smart card at the second computer; and 


12 


(0 


transferring value from said first smart card on the first computer to said second smart 


13 




card on said second computer over said network utilizing said secure protocol. 


1 


6. 


The method as recited in claim 5, including: 


2 


(d) 


transmitting encrypted payment information from said first computer to said second 


3 




computer; 


4 


(e) 


receiving said encrypted payment information at said second computer 


5 




and decrypting the payment information utilizing the decryption procedure; and 


6 


(0 


performing further payment processing on said decrypted information. 


1 


7. 


The method as recited in claim 5, wherein said authentication information is obtained 


2 




via a telephone, fax machine or electronic mail. 


1 


8. 


The method as recited in claim 5, wherein a digital signature is utilized to authenticate 


2 




payment processing. 



1 

2 



9. 



The method as recited in claim 7, wherein said client information is obtained via a 
secure general purpose protocol. 
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10. 


tu- wa fU^ ao rp^itpH m Hnim s further comDrises reversing previous value transfer 
I ne metnoa as recited in cicuiii o> lunuv-i *~uni^i * ^ » — r* ^ * 


2 




transactions. 


1 


11. 


a *. . tv - 4.* _ AAmmnniraHrtn hpfwepfl a first COITlDUter and a SeCOnd 

Apparatus for initiating secure comrnunicauun uciwccu a mai tuiupuiv* c4ji " 


2 




computer under the control of software with an attached display ana an input ucvitc 


3 




• « . i r ,i *» _ _ yJ rfar-ri r-< n train A f T"/^m a fir^t CfI13rt Ca_T(J 

coupled to a network for authenticating and transiemng vaiue irom a nrsi muoi i u*u u 


4 




to a second smart card, comprising: 


5 


(a) 


- 11 „*-Ki;*.v.;i-ir» a mmmnnimtinn link between said first computer and said 

means ior estaDiismng b comrouiucaLiuii mixv uciwv.ui >» uiu r 


6 




second computer via said network; 


7 


(b) 


means for identifying an encryption procedure and a decryption procedure utilized oy 


8 




said first computer and said second computer; 


9 


(c| 


means coupled to the means for establishing a communication unK ior iran^raiLung 


10 




encrypted authentication information, from said second computer to said first computer 


11 




using the communication link; 


12 


(d) 


means for receiving said encrypted authentication information at said first computer 


13 




using the communication link and decrypting the authentication information utilizing 


14 




the decryption procedure to authenticate said second smart card and said first smart 


15 




card; 


16 


(e) 


means for reading the first smart card at the nrst computer, 


17 


M 


means for reading the second smart card at the second computer; and 


18 


(g) 


means for transferring value from said first smart card at said first computer to said 


19 




second smart card at said second computer over the network. 


1 


12. 


The apparatus as recited in claim 1 1, wherein the network is an Internet. 


1 


13. 


The apparatus as recited in claim 12, including means for transmitting from the second 


2 




computer system to a third computer system for authorizing or denying credit in the 


3 




payment processing. 
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1 


14. 


An apparatus for initiating secure communication between a first and a second 


2 




computer connected to a network for receiving and transmitting payment information, 


3. 




comprising: 


4 


la) 


communication hardware utilized by a client to communicate information for use in said 


5 




secure communication between a first and a second computer; 


6 


(b) 


a computer under the control of software which establishes secure communication 


7 




between said first and said second computer via said network: 


8 


(c) 


a computer under the control of software which repackages said payment information to 


9 




comply with a third party secure protocol for further payment processing; 


10 


(d) 


means for reading a first smart card at the first computer; 


11 


(e) 


means for reading a second smart card at the second computer; and 


12 


w 


means for transferring value from said first smart card at the first computer to said 


13 




second smart card at the second computer utilizing the network. 


1 


15. 


A computer program embodied on a computer-readable medium in a first computer 


2 




under the control of software with an attached display and an input device connected to 


3 




a network for receiving and transmitting network information, comprising: 


4 


(a) 


a code segment for establishing a communication between a first computer and a 


5 




second computer via said network; 


6 


(b) 


a code segment for identifying an encryption procedure and a decryption procedure 


7 




utilized by said first computer and said second computer; 


8 


(c) 


a code segment for transmitting encrypted authentication information from said second 


9 




computer to said first computer; 


10 


(d) 


a code segment for receiving said encrypted authentication information at said first 


11 




computer and decrypting the authentication information utilizing the decryption 


12 




procedure; 


13 


(e) 


a code segment for reading a first smart card at said first computer; 


14 


(0 


a code segment for reading a second smart card at said second computer; and 


15 


(g) 


a code segment for transferring value from said first smart card at said first computer to 


16 




said second smart card at said second computer utilizing said network. 
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1 16. A computer program embodied on a computer-readable medium for authenticating and 

2 transferring value from a first smart card attached to a first computer connected by 

3 network to a second smart card attached to a second computer connected by a network 

4 for receiving and transmitting network information, comprising: 

5 (a) a code segment for communicating secure information between said first and said 

6 second computer; 

7 (b) a code segment for establishing secure communication between said first and said 

8 second computer via said network; 

9 (c) a code segment for reading a first smart card attached to said first computer; 

1 0 (e) a code segment for reading a second smart card attached to said second computer; and 

1 1 (f) a code segment for transferring value from said first smart card attached to said first 

1 2 computer through said secure communication between said first computer and said 

13 second computer via said network to said second smart card attached to said second 

14 computer. 
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[f you wish to have billing defaults set in your browser, check this box 

Total = $ 59.99 

By pressing the PAY button I agree to pay the above total amount 
according to the card issuer agreement 
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Host Communication 



This screw allows the user to configure the parameters for the 
vGATE to communicate with the Host adaptor device. The . 
parameters needed are: (^4 * 
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About vCATE 




The Host Multiplexer server is running. Click on the Stop button to 
stop the server 
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